CodeModel2.AddNamespace (Método)

Artículo
05/17/2015

Crea una nueva construcción de código de espacio de nombres e inserta el código en la ubicación adecuada.

Espacio de nombres: EnvDTE80
Ensamblado: EnvDTE80 (en EnvDTE80.dll)

Sintaxis

'Declaración
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

Parámetros

Name
Tipo: String

Obligatorio. Nombre del nuevo espacio de nombres.

Location
Tipo: Object

Obligatorio. Ruta de acceso y nombre de archivo correspondientes a la nueva definición de espacio de nombres. En función del lenguaje, el nombre de archivo será relativo o absoluto con respecto al archivo de proyecto. El archivo se agregará al proyecto si todavía no es un elemento del mismo. Si no es posible crear el archivo y agregarlo al proyecto, AddNamespace producirá un error.

Position
Tipo: Object

Opcional. Valor predeterminado = 0. Elemento de código tras el que se agrega el elemento nuevo. Si el valor es un CodeElement, el nuevo elemento se agregará inmediatamente tras él.

Si el valor es Long, AddNamespace indicará el elemento tras el cual se agregará el nuevo elemento.

Como el recuento de los elementos de una colección comienza a partir de 1, pasar un valor de 0 indica que el nuevo elemento deberá colocarse al principio de la colección. Un valor de -1 indica que el elemento deberá situarse al final de la colección.

Valor devuelto

Tipo: CodeNamespace
Un objeto CodeNamespace.

Comentarios

Visual C++ nativo requiere el formato de separación por signos de dos puntos (::) para sus nombres de tipo completos; el resto de los lenguajes admiten el formato de separación por puntos.

La corrección de los argumentos vendrá determinada por el lenguaje que subyace al modelo de código.

Nota

Los valores de los elementos de modelo de código como clases, structs, funciones, atributos, delegados, etc., pueden ser no deterministas una vez realizados determinados tipos de modificaciones; esto significa que no se puede confiar en que sus valores se mantengan siempre igual.Para obtener más información, vea la sección Los valores de elementos de modelo de código pueden cambiar, en Detectar código utilizando el modelo de código (Visual Basic).

Ejemplos

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);
    }
}

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.