Aracılığıyla paylaş

  • Makale

IDTSVirtualInput100.SetUsageType Yöntemi

Sanal giriş sütun nesne eşleştirir ve kullanım türünü ayarlar.

Ad Alanı:  Microsoft.SqlServer.Dts.Pipeline.Wrapper
Derleme:  Microsoft.SqlServer.DTSPipelineWrap (Microsoft.SqlServer.DTSPipelineWrap içinde.dll)

Sözdizimi

'Bildirim
Function SetUsageType ( _
    lLineageID As Integer, _
    eUsageType As DTSUsageType _
) As Integer
'Kullanım
Dim instance As IDTSVirtualInput100
Dim lLineageID As Integer
Dim eUsageType As DTSUsageType
Dim returnValue As Integer

returnValue = instance.SetUsageType(lLineageID, _
    eUsageType)

int SetUsageType(
    int lLineageID,
    DTSUsageType eUsageType
)

int SetUsageType(
    [InAttribute] int lLineageID, 
    [InAttribute] DTSUsageType eUsageType
)

abstract SetUsageType : 
        lLineageID:int * 
        eUsageType:DTSUsageType -> int 

function SetUsageType(
    lLineageID : int, 
    eUsageType : DTSUsageType
) : int

Parametreler

Dönüş Değeri

Tür: System.Int32
Yeni oluşturulan dizini IDTSInputColumn100, veya -1 eUsageType olan UT_IGNORED sütun giriş sütun kaldırılır ve koleksiyon.

Açıklamalar

Özel bileşen geliştiricileri çağrısı bu yöntem genellikle temel sınıf geçersiz kılınmış kendi uygulamasında SetUsageType yöntemi eklemek veya sütun giriş sütun kaldırmak için koleksiyon bileşen.eUsageType Olan UT_IGNORED, ve sütun giriş sütun için önceden eklenmiş olan koleksiyon bileşeni olan sütun dizini kaldırılır.eUsageType Olan UT_READONLY, veya UT_READWRITE, sütun eklenir koleksiyon.

Bu yöntem, program aracılığıyla veri akışı görevi oluşturma ve bileşenleri için sütunları seçme görevi geliştiriciler tarafından çağrılmamalıdır.Bunun yerine, SetUsageType yöntem, tasarım -saat bileşen örnek denir.Bu çağrı yöntem sütun veri türü veya kullanım türü ile sınırlamak için bileşenin yeteneği doğrudan atlar.

Örnekler

Geçersiz kılınmış bir bileşenin uygulanması aşağıdaki kod örneği gösterir SetUsageType sanal giriş'ın kullandığı SetUsageType eklemek ve girişten sütunları kaldırmak için koleksiyon.Bu örnekte, yazılabilir olmasını sütunları izin vermez bunu ne zaman eUsageType olan UT_READWRITE özel durum oluşur.

public override IDTSInputColumn100 SetUsageType(int inputID, IDTSVirtualInput100 virtualInput, int lineageID, DTSUsageType usageType)
{
    // Prevent use of read/write columns.
    if (usageType == DTSUsageType.UT_READWRITE)
        throw new Exception("Read write columns prohibited.");

    // Get the input specified by inputID.
    IDTSInput100 input = ComponentMetaData.InputCollection.GetObjectByID(inputID);

    int index = virtualInput.SetUsageType(lineageID, usageType);

    // If the index is not -1, return the column.
    // NOTE: The index that is returned is 1-based, but the input column collection is 0-based.
    if ( index != -1 )
        return input.InputColumnCollection[index-1];

    // The column was removed, so return null.
    return null;
}

Public Overrides Function SetUsageType(ByVal inputID As Integer, ByVal virtualInput As IDTSVirtualInput100, ByVal lineageID As Integer, ByVal usageType As DTSUsageType) As IDTSInputColumn100 
 If usageType = DTSUsageType.UT_READWRITE Then 
   Throw New Exception("Read write columns prohibited.") 
 End If 
 Dim input As IDTSInput100 = ComponentMetaData.InputCollection.GetObjectByID(inputID) 
 Dim index As Integer = virtualInput.SetUsageType(lineageID, usageType) 
 If Not (index = -1) Then 
   Return input.InputColumnCollection(index - 1) 
 End If 
 Return Nothing 
End Function