CodeModel.AddNamespace 方法

發行項
08/12/2011

建立新的命名空間程式碼建構並將程式碼插入正確位置。

命名空間： EnvDTE
組件： EnvDTE (在 EnvDTE.dll 中)

語法

'宣告
Function AddNamespace ( _
    Name As String, _
    Location As Object, _
    Position As Object _
) As CodeNamespace

CodeNamespace AddNamespace(
    string Name,
    Object Location,
    Object Position
)

CodeNamespace^ AddNamespace(
    String^ Name, 
    Object^ Location, 
    Object^ Position
)

abstract AddNamespace : 
        Name:string * 
        Location:Object * 
        Position:Object -> CodeNamespace

function AddNamespace(
    Name : String, 
    Location : Object, 
    Position : Object
) : CodeNamespace

參數

Name
型別：System.String
必要項。新命名空間名稱。

Location
型別：System.Object
必要項。新命名空間定義的路徑和檔名。根據程式語言的不同，檔名可能與專案檔相關或完全一致。如果這個檔案目前不是專案項目，將會將它加入到專案中。如果無法建立這個檔案並將它加入到專案，則 AddNamespace 失敗。

Position
型別：System.Object
選擇項。預設 = 0。其後要加入新項目的程式碼項目。如果這個值是 CodeElement，則會緊接在其後加入新項目。
如果這個值是 Long 資料型別，那麼 AddNamespace 會指示其後要加入新項目的項目。
由於集合是從 1 開始計算，傳遞 0 表示新的項目必須放在集合起始的位置。值為 -1 時表示這個項目必須放在結尾。

傳回值

型別：EnvDTE.CodeNamespace
CodeNamespace 物件。

備註

原生 Visual C++ 的完整型別名稱必須使用冒號 (::) 分隔。其他所有語言都支援句號分隔的格式。

引數的正確性取決於程式碼模型後的程式語言。

注意事項
在特定類型的編輯之後，程式碼模型項目 (例如類別、結構、函式、屬性、委派等) 的值可能不具決定性，表示其值不一定維持相同。如需詳細資訊，請參閱使用程式碼模型探索程式碼 (Visual Basic) 的＜程式碼模型項目值可以變更＞一節。

範例

Sub AddNamespaceCodeModel(ByVal dte As DTE2)

    ' Before running this example, open a code document from a project.
    Try
        ' Create a new namespace.
        Dim projItem As ProjectItem = dte.ActiveDocument.ProjectItem
        Dim cm As CodeModel = projItem.ContainingProject.CodeModel
        cm.AddNamespace("TestNamespace", projItem.Name)
    Catch ex As Exception
        MsgBox(ex.Message)
    End Try

End Sub

public void AddNamespaceCodeModel(DTE2 dte)
{
    // Before running this example, open a code document from 
    // a project.
    try
    {
        // Create a new namespace.
        ProjectItem projItem = dte.ActiveDocument.ProjectItem;
        CodeModel cm = projItem.ContainingProject.CodeModel;
        cm.AddNamespace("TestNamespace", projItem.Name, -1);
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}