ImportAttribute 클래스

정의

네임스페이스:: System.ComponentModel.Composition

어셈블리:: System.ComponentModel.Composition.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

CompositionContainer.object에서 속성, 필드 또는 매개 변수 값을 제공하도록 지정합니다.

public ref class ImportAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false, Inherited=false)]
public class ImportAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false, Inherited=false)>]
type ImportAttribute = class
    inherit Attribute

Public Class ImportAttribute
Inherits Attribute

상속: Object

Attribute
ImportAttribute

특성: AttributeUsageAttribute

예제

다음 예제에서는 멤버가 데코레이트된 ImportAttribute세 개의 클래스와 일치하는 3개의 내보내기를 보여 줍니다.

//Default export infers type and contract name from the
//exported type.  This is the preferred method.
[Export]
public class MyExport1
{
    public String data = "Test Data 1.";
}

public class MyImporter1
{
    [Import]
    public MyExport1 importedMember { get; set; }
}

public interface MyInterface
{
}

//Specifying the contract type may be important if
//you want to export a type other then the base type,
//such as an interface.
[Export(typeof(MyInterface))]
public class MyExport2 : MyInterface
{
    public String data = "Test Data 2.";
}

public class MyImporter2
{
    //The import must match the contract type!
    [Import(typeof(MyInterface))]
    public MyExport2 importedMember { get; set; }
}

//Specifying a contract name should only be
//needed in rare caes. Usually, using metadata
//is a better approach.
[Export("MyContractName", typeof(MyInterface))]
public class MyExport3 : MyInterface
{
    public String data = "Test Data 3.";
}

public class MyImporter3
{
    //Both contract name and type must match!
    [Import("MyContractName", typeof(MyInterface))]
    public MyExport3 importedMember { get; set; }
}

class Program
{

    static void Main(string[] args)
    {
        AggregateCatalog catalog = new AggregateCatalog();
        catalog.Catalogs.Add(new AssemblyCatalog(typeof(MyExport1).Assembly));
        CompositionContainer _container = new CompositionContainer(catalog);
        MyImporter1 test1 = new MyImporter1();
        MyImporter2 test2 = new MyImporter2();
        MyImporter3 test3 = new MyImporter3();
        _container.SatisfyImportsOnce(test1);
        _container.SatisfyImportsOnce(test2);
        _container.SatisfyImportsOnce(test3);
        Console.WriteLine(test1.importedMember.data);
        Console.WriteLine(test2.importedMember.data);
        Console.WriteLine(test3.importedMember.data);
        Console.ReadLine();
    }
}

'Default export infers type and contract name from the
'exported type.  This is the preferred method.
<Export()>
Public Class MyExport1
    Public ReadOnly Property data As String
        Get
            Return "Test Data 1."
        End Get
    End Property
End Class

Public Class MyImporter1

    <Import()>
    Public Property ImportedMember As MyExport1

End Class

Public Interface MyInterface

End Interface

'Specifying the contract type may be important if
'you want to export a type other then the base type,
'such as an interface.
<Export(GetType(MyInterface))>
Public Class MyExport2
    Implements MyInterface
    Public ReadOnly Property data As String
        Get
            Return "Test Data 2."
        End Get
    End Property
End Class

Public Class MyImporter2
    'The import must match the contract type!
    <Import(GetType(MyInterface))>
    Public Property ImportedMember As MyExport2
End Class

'Specifying a contract name should only be 
'needed in rare caes. Usually, using metadata
'is a better approach.
<Export("MyContractName", GetType(MyInterface))>
Public Class MyExport3
    Implements MyInterface
    Public ReadOnly Property data As String
        Get
            Return "Test Data 3."
        End Get
    End Property
End Class

Public Class MyImporter3
    'Both contract name and type must match!
    <Import("MyContractName", GetType(MyInterface))>
    Public Property ImportedMember As MyExport3
End Class



Sub Main()
    Dim catalog As AggregateCatalog = New AggregateCatalog()
    catalog.Catalogs.Add(New AssemblyCatalog(GetType(MyExport1).Assembly))
    Dim container As CompositionContainer = New CompositionContainer(catalog)
    Dim test1 As MyImporter1 = New MyImporter1()
    Dim test2 As MyImporter2 = New MyImporter2()
    Dim test3 As MyImporter3 = New MyImporter3()
    container.SatisfyImportsOnce(test1)
    container.SatisfyImportsOnce(test2)
    container.SatisfyImportsOnce(test3)
    Console.WriteLine(test1.ImportedMember.data)
    Console.WriteLine(test2.ImportedMember.data)
    Console.WriteLine(test3.ImportedMember.data)
    Console.ReadLine()
End Sub

설명

특성 프로그래밍 모델 ImportAttribute 에서 지정된 부분의 가져오기 또는 종속성을 선언하는 데 사용됩니다. 속성, 필드 또는 메서드를 데코레이트할 수 있습니다. 컴퍼지션 중에 파트의 가져오기는 해당 개체에 CompositionContainer 제공된 CompositionContainer 내보내기를 사용하여 해당 파트가 속한 개체로 채워집니다.

가져오기가 지정된 내보내기와 일치하는지 여부는 주로 계약 이름과 계약 유형을 비교하여 결정됩니다. 일반적으로 코드에서 가져오기 특성을 사용할 때 이러한 특성 중 하나를 지정할 필요가 없으며 데코레이팅된 멤버의 형식에서 자동으로 유추됩니다. 가져오기가 다른 형식의 내보내기(예: 데코레이팅된 멤버 형식의 서브클래스 또는 해당 멤버가 구현한 인터페이스)를 일치시켜야 하는 경우 계약 형식을 명시적으로 지정해야 합니다. 계약 이름을 명시적으로 지정할 수도 있습니다. 예를 들어 동일한 형식의 여러 계약을 구분할 수 있지만 일반적으로 메타데이터를 통해 이 작업을 수행하는 것이 좋습니다. 메타데이터에 대한 자세한 내용은 다음을 참조하세요 PartMetadataAttribute.

생성자

Name	Description
ImportAttribute()	기본 계약 이름으로 내보내기를 가져와 클래스의 ImportAttribute 새 인스턴스를 초기화합니다.
ImportAttribute(String, Type)	지정된 계약 이름 및 형식을 사용하여 내보내기를 가져와 클래스의 ImportAttribute 새 인스턴스를 초기화합니다.
ImportAttribute(String)	지정된 계약 이름으로 내보내기를 가져와 클래스의 ImportAttribute 새 인스턴스를 초기화합니다.
ImportAttribute(Type)	지정된 형식에서 파생된 계약 이름으로 내보내기를 가져와 클래스의 ImportAttribute 새 인스턴스를 초기화합니다.

속성

Name	Description
AllowDefault	계약 이름의 내보내기가 컨테이너에 없을 때 속성, 필드 또는 매개 변수를 해당 형식의 기본값으로 설정할지 여부를 나타내는 값을 가져오거나 설정합니다.
AllowRecomposition	컨테이너에서 일치하는 계약으로 내보내기가 변경될 때 속성 또는 필드가 다시 컴파일될지 여부를 나타내는 값을 가져오거나 설정합니다.
ContractName	가져올 내보내기의 계약 이름을 가져옵니다.
ContractType	가져올 내보내기의 형식을 가져옵니다.
RequiredCreationPolicy	가져오기에 이 가져오기를 충족하는 데 사용되는 내보내기에서 특정 CreationPolicy 항목이 필요했음을 나타내는 값을 가져오거나 설정합니다.
Source	이 가져오기가 충족될 수 있는 범위를 지정하는 값을 가져오거나 설정합니다.
TypeId	파생 클래스에서 구현되는 경우 이 Attribute대한 고유 식별자를 가져옵니다. (다음에서 상속됨 Attribute)

메서드

Name	Description
Equals(Object)	이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
GetHashCode()	이 인스턴스의 해시 코드를 반환합니다. (다음에서 상속됨 Attribute)
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
IsDefaultAttribute()	파생 클래스에서 재정의되는 경우 이 인스턴스의 값이 파생 클래스의 기본값인지 여부를 나타냅니다. (다음에서 상속됨 Attribute)
Match(Object)	파생 클래스에서 재정의되는 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

명시적 인터페이스 구현

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	이름 집합을 해당 디스패치 식별자 집합에 매핑합니다. (다음에서 상속됨 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	인터페이스의 형식 정보를 가져오는 데 사용할 수 있는 개체의 형식 정보를 검색합니다. (다음에서 상속됨 Attribute)
_Attribute.GetTypeInfoCount(UInt32)	개체가 제공하는 형식 정보 인터페이스의 수를 검색합니다(0 또는 1). (다음에서 상속됨 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	개체에 의해 노출되는 속성 및 메서드에 대한 액세스를 제공합니다. (다음에서 상속됨 Attribute)

적용 대상

추가 정보

피드백

이 페이지가 도움이 되었나요?