ForEachSMOEnumerator.EnumURN Propriedade

Definição

Namespace:

Microsoft.SqlServer.Dts.Runtime.Enumerators.SMO

Assembly:

Microsoft.SqlServer.ForEachSMOEnumerator.dll

Obtém ou define uma cadeia de caracteres que contém a URN (Uniform Resource Name) de enumeração SMO para a enumeração selecionada.

public:
 property System::String ^ EnumURN { System::String ^ get(); void set(System::String ^ value); };

public string EnumURN { get; set; }

member this.EnumURN : string with get, set

Public Property EnumURN As String

Valor da propriedade

String

Uma cadeia de caracteres que contém os parâmetros de configuração do enumerador.

Implementações

EnumURN

Exemplos

O ForEachSMOEnumerator objeto é criado e hospedado por um ForEachEnumeratorHost. O exemplo de código a seguir mostra como criar um ForEachSMOEnumerator dentro do objeto host.

using System;  
using System.Collections.Generic;  
using System.Text;  
using Microsoft.SqlServer.Dts.Runtime.Enumerators.SMO;  
using Microsoft.SqlServer.Dts.Runtime;  

namespace Microsoft.SqlServer.SSIS.Samples  
{  
    internal class EnumType  
    {  
        public const string SMOEnum = "Foreach SMO Enumerator";  
    }  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Application app = new Application();  
            ForEachEnumeratorInfos infos = app.ForEachEnumeratorInfos;  
            ForEachEnumeratorInfo info = null;  

            foreach (ForEachEnumeratorInfo enumInfo in infos)  
            {  
            Console.Write("Available enumerators: {0}\n", enumInfo.Name);  
            // When the SMO enumerator is found, set the info variable.  
            if (enumInfo.Name == EnumType.SMOEnum)  
            {    
                info = enumInfo;  
            }  
        }  

        ForEachEnumeratorHost enumH = info.CreateNew();  
        Console.WriteLine("SMO Enumerator: " + enumH.InnerObject.ToString());  
        ForEachSMOEnumerator smoEnumerator = (ForEachSMOEnumerator)enumH.InnerObject;  
        smoEnumerator.EnumURN = "RuntimeServer[@Variable='MachineName']/Server[@Name='localhost']/" +  
            "SMOEnumObj[@Name='Databases']/SMOEnumType[@Name='Names']";  
    Console.WriteLine("SMO.EnumURN = {0}", smoEnumerator.EnumURN);  
        }  
    }  
}  

Imports System  
Imports System.Collections.Generic  
Imports System.Text  
Imports Microsoft.SqlServer.Dts.Runtime.Enumerators.SMO  
Imports Microsoft.SqlServer.Dts.Runtime  

Namespace Microsoft.SqlServer.SSIS.Samples  
    Friend Class EnumType  
        Public const String SMOEnum = "Foreach SMO Enumerator"  
    End Class  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim app As Application =  New Application()   
            Dim infos As ForEachEnumeratorInfos =  app.ForEachEnumeratorInfos   
            Dim info As ForEachEnumeratorInfo =  Nothing   

            Dim EnumInfo As ForEachEnumeratorInfo   
            Dim enumInfo As ForEachEnumeratorInfo  
            End Enum  
            For Each EnumInfo In infos   
            For Each EnumInfo In infos Console.Write("Available enumerators: {0}\n" EnumInfo.Name) End Enum   
            For Each enumInfo In infos  
            Console.Write("Available enumerators: {0}\n" enumInfo.Name)  
            End Enum  
            End Enum  
            ' When the SMO enumerator is found, set the info variable.  
            If EnumInfo.Name = EnumType.SMOEnum Then   
            Dim EnumInfo.Name As If =  EnumType.SMOEnum Then info  =  EnumInfo  End Enum  
            If enumInfo.Name = EnumType.SMOEnum Then  
                info = enumInfo  
            End Enum  
            End Enum  
            End If  
            Next  

        Dim EnumH As ForEachEnumeratorHost =  info.CreateNew()   
        Dim enumH As ForEachEnumeratorHost =  info.CreateNew()   
        End Enum  
        Console.WriteLine("SMO Enumerator: " + EnumH.InnerObject.ToString())   
        Console.WriteLine("SMO Enumerator: " + enumH.InnerObject.ToString())  
        End Enum  
        Dim smoEnumerator As ForEachSMOEnumerator = CType(EnumH.InnerObject, ForEachSMOEnumerator)  
        Dim smoEnumerator As ForEachSMOEnumerator = CType(enumH.InnerObject, ForEachSMOEnumerator)  
        End Enum  
        smoEnumerator.EnumURN = "RuntimeServer[@Variable='MachineName']/Server[@Name='localhost']/" +  
            "SMOEnumObj[@Name='Databases']/SMOEnumType[@Name='Names']"  
        Console.WriteLine("SMO.EnumURN = {0}", smoEnumerator.EnumURN)  
        End Sub  
    End Class  
End Namespace  

Saída de exemplo:

Enumeradores disponíveis: Enumerador de Arquivos Foreach

Enumeradores disponíveis: Enumerador de Item Foreach

Enumeradores disponíveis: Enumerador foreach ADO

Enumeradores disponíveis: Foreach ADO.NET Enumerador de conjunto de linhas de esquema

Enumeradores disponíveis: Foreach from Variable Enumerator

Enumeradores disponíveis: Enumerador NodeList foreach

Enumeradores disponíveis: Enumerador de SMO foreach

Enumerador SMO: Microsoft.SqlServer.Dts.Runtime.Enumerators.SMO.ForEachSMOEnumerator

Smo. EnumURN = RuntimeServer[@Variable='MachineName']/Server[@Name='localhost']/SMOEnumObj[@Name='Databases']/SMOEnumType[@Name='Names']

Comentários

A URN de enumeração SMO contém quatro partes. Primeiro é a cadeia de caracteres, RuntimeServer. seguido por uma conexão. A linha de código a seguir é um exemplo de uma EnumURN propriedade em que uma conexão foi especificada.

RuntimeServer[@Connection='{B1552E8D-43AE-44B1-B5D3-03C4F5461977}']/Server[@Name='localhost']/SMOEnumObj[@Name='Databases']/SMOEnumType[@Name='Names']

A segunda parte da cadeia de caracteres é o parâmetro de nome do servidor.

As duas últimas partes da cadeia de caracteres são os parâmetros e SMOEnumType os SMOEnumObj parâmetros. O SMOEnumObj parâmetro, que vem em terceiro lugar na cadeia de caracteres de quatro partes, descreve qual objeto de enumeração é enumerado. Os valores válidos são:

@"LinkedServers"

@"Jobs"

@"Logins"

@"Databases"

@"FileGroups"

@"DataFiles"

@"LogFiles"

@"StoredProcedures"

@"UserDefinedDataTypes"

@"UserDefinedFunctions"

@"Views"

@"Users"

@"Tables"

@"Columns"

@"ForeignKeys"

@"Gatilhos

O exemplo de código acima mostra uma enumeração em bancos de dados.

A quarta e última parte da cadeia de caracteres de configuração é o SMOEnumType parâmetro, que especifica o tipo de enumeração a ser usado. Os valores válidos são:

@"Objects"

@"ObjectsPP"

@"Names"

@"URNs"

@"Locations"

O exemplo de código acima enumera usando nomes.