ContractBasedImportDefinition Constructor (String, String, IEnumerable<KeyValuePair<String, Type>>, ImportCardinality, Boolean, Boolean, CreationPolicy)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Initializes a new instance of the ContractBasedImportDefinition class with the specified contract name, required type identity, required metadata, cardinality, a value that indicates if the import definition is recomposable, a value that indicates if the import definition is a prerequisite, and a value that indicates the required creation policy.

Namespace:  System.ComponentModel.Composition.Primitives
Assembly:  System.ComponentModel.Composition (in System.ComponentModel.Composition.dll)

Syntax

'Declaration
Public Sub New ( _
    contractName As String, _
    requiredTypeIdentity As String, _
    requiredMetadata As IEnumerable(Of KeyValuePair(Of String, Type)), _
    cardinality As ImportCardinality, _
    isRecomposable As Boolean, _
    isPrerequisite As Boolean, _
    requiredCreationPolicy As CreationPolicy _
)

public ContractBasedImportDefinition(
    string contractName,
    string requiredTypeIdentity,
    IEnumerable<KeyValuePair<string, Type>> requiredMetadata,
    ImportCardinality cardinality,
    bool isRecomposable,
    bool isPrerequisite,
    CreationPolicy requiredCreationPolicy
)

Parameters

• contractName
  Type: System.String
  A string that contains the contract name of the Export object required by the ContractBasedImportDefinition.

• requiredTypeIdentity
  Type: System.String
  The type identity of the export type expected. Use the GetTypeIdentity method to generate a type identity for a given type. If no specific type is required, use nulla null reference (Nothing in Visual Basic).

• requiredMetadata
  Type: System.Collections.Generic.IEnumerable<KeyValuePair<String, Type>>
  A collection of key/value pairs containing the metadata names and types required by the ContractBasedImportDefinition; or nulla null reference (Nothing in Visual Basic) to set the RequiredMetadata property to an empty IEnumerable<T> collection.

• cardinality
  Type: System.ComponentModel.Composition.Primitives.ImportCardinality
  One of the ImportCardinality values that indicates the cardinality of the Export objects required by the ContractBasedImportDefinition.

• isRecomposable
  Type: System.Boolean
  true to specify that the ContractBasedImportDefinition can be satisfied multiple times throughout the lifetime of a ComposablePart; otherwise, false.

• isPrerequisite
  Type: System.Boolean
  true to specify that the ContractBasedImportDefinition is required to be satisfied before a ComposablePart can start producing exported objects; otherwise, false.

• requiredCreationPolicy
  Type: System.ComponentModel.Composition.CreationPolicy
  A value that indicates that the importer requires a specific CreationPolicy for the exports used to satisfy this import. If no specific CreationPolicy is needed, the default is Any.

Exceptions

Exception	Condition
ArgumentNullException	contractName is nulla null reference (Nothing in Visual Basic).
ArgumentException	contractName is an empty string (""). -or- requiredMetadata contains an element that is nulla null reference (Nothing in Visual Basic). -or- cardinality is not one of the ImportCardinality values.

Version Information

Silverlight

Supported in: 5, 4

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

See Also

Reference

ContractBasedImportDefinition Class

ContractBasedImportDefinition Overload

System.ComponentModel.Composition.Primitives Namespace