概要

Editor はジオデータベースのシンクライアントです。Editor クラスに公開されている多くのメソッドは、ワークスペースで利用できるメソッドと密接に関わってマッピングされています。以下はメソッドの対応表です。

ArcMap のエクステンションを書く場合、多くのケースで Editor のメソッドが内部的にジオデータベースのメソッドを呼ぶため、これらは Editor メソッドの代わりに利用されるべきではなく、交互に用いられるべきでもありません。Editor メソッドはしばしば追加のロジックも実行しますが、その中には適切なイベントの発行、選択状態の管理、属性ダイアログボックス等の Editor 関連のユーザー インターフェイス コンポーネントの管理等が含まれます。

編集セッションの開始

public bool StartEditing(ESRI.ArcGIS.Geodatabase.IWorkspace workspaceToEdit)
{
    //editor への参照を取得する。
    UID uid = new UIDClass();
    uid.Value = "esriEditor.Editor";
    IEditor editor = m_application.FindExtensionByCLSID(uid)as IEditor;

    //ワークスペースがすでに編集中でないか調べる。
    if (editor.EditState == esriEditState.esriStateNotEditing)
    {
        editor.StartEditing(workspaceToEdit);
        return true;
    }
    else
    {
        return false;
    }
}

Public Function StartEditing(ByVal workspaceToEdit As ESRI.ArcGIS.Geodatabase.IWorkspace) As Boolean
    
    'editor への参照を取得する。
    Dim uid As UID
    uid = New UIDClass()
    uid.Value = "esriEditor.Editor"
    Dim editor As IEditor
    editor = CType(m_application.FindExtensionByCLSID(uid), IEditor)
    
    'ワークスペースがすでに編集中でないか調べる。
    If editor.EditState = esriEditState.esriStateNotEditing Then
        editor.StartEditing(workspaceToEdit)
        Return True
    Else
        Return False
    End If

End Function
 

編集の保存

編集オペレーションの操作

 
private void EditOperationTest(IEditor m_editor)
{

    //編集オペレーションを開始する
    m_editor.StartOperation();

    //処理を行う部分
    // ...
    //End work.

    //１回目をクロースする前に２回目の編集オペレーションを開始する。例外がスローされる
    m_editor.StartOperation();
}

 Private Sub EditOperationTest(ByVal m_editor As IEditor)
    
    '編集オペレーションを開始する
    m_editor.StartOperation()
    
    '処理を行う部分
    ' ...
    'End work.
    
    '１回目をクロースする前に２回目の編集オペレーションを開始する。
    m_editor.StartOperation()
    
End Sub

この理由から、StartOperation と StopOperation の呼び出しの間に実行されるコードは最小限にし、コードの可読性を高め、入れ子になった 編集オペレーションを開始するようなことは極力減らします。 すでに編集オペレーション内にいるかどうかも調べることができます。以下のコード例は、編集オペレーションの状態であるかどうかを調べる方法です。

private void EditOperation(IEditor m_editor)
{
  //操作中であるかどうか調べる
  IWorkspaceEdit2 workspaceEdit = (IWorkspaceEdit2)m_editor.EditWorkspace;

  if (!workspaceEdit.IsInEditOperation)
  {
    // 最初のオペレーションを閉じる
    m_editor.StopOperation("edit");
  }
}

Private Sub EditOperation(ByVal m_editor As IEditor)
    
    '操作中であるかどうか調べる
    Dim workspaceEdit As IWorkspaceEdit2 = CType(m_editor.EditWorkspace, IWorkspaceEdit2)
    
    If (Not workspaceEdit.IsInEditOperation) Then
        ' 最初のオペレーションを閉じる
        m_editor.StopOperation("edit")
    End If
End Sub

ノンバージョンの編集セッション

private void AddClass(IEditor m_editor, IFeatureClass featureClass)
{
    IEditAttributeProperties editAttributeProps = (IEditAttributeProperties)m_editor;

    // コミット前に新しいフィーチャの属性クエリを可とする.
    editAttributeProps.NonversionedAttributionEnabled = true;

    // 特定のフィーチャクラスに限定する
    editAttributeProps.AttributeEditAll = false;

    // フィーチャクラスが指定されていなければ新しく追加する
    if (editAttributeProps.AttributeEditClasses == null)
    {
        editAttributeProps.AttributeEditClasses = new SetClass();
        editAttributeProps.AttributeEditClasses.Add(featureClass);
        return ;
    }

    // null でない場合、フィーチャクラスが存在するかの確認と追加
    if (editAttributeProps.AttributeEditClasses.Count == 0 ||
        !editAttributeProps.AttributeEditClasses.Find(featureClass))
    {
        editAttributeProps.AttributeEditClasses.Add(featureClass);
    }
}

Private Sub AddClass(ByVal m_editor As IEditor, ByVal featureClass As IFeatureClass)
    
    Dim editAttributeProps As IEditAttributeProperties = CType(m_editor, IEditAttributeProperties)
    
    ' コミット前に新しいフィーチャの属性クエリを可とする.
    editAttributeProps.NonversionedAttributionEnabled = True
    
    ' 特定のフィーチャクラスに限定する
    editAttributeProps.AttributeEditAll = False
    
    ' フィーチャクラスが指定されていなければ新しく追加する
    If editAttributeProps.AttributeEditClasses Is Nothing Then
        editAttributeProps.AttributeEditClasses = New SetClass()
        editAttributeProps.AttributeEditClasses.Add(featureClass)
        Return
    End If
    
    ' null でない場合、フィーチャクラスが存在するかの確認と追加
    If editAttributeProps.AttributeEditClasses.Count = 0 OrElse (Not editAttributeProps.AttributeEditClasses.Find(featureClass)) Then
        editAttributeProps.AttributeEditClasses.Add(featureClass)
    End If
    
End Sub