ServiceModel-Attribute und ServiceDescription-ReferenzServiceModel Attributes and ServiceDescription Reference

Die beschreibungsstruktur ist die Hierarchie der Typen (beginnend mit der System.ServiceModel.Description.ServiceDescription Klasse), die zusammen jeden Aspekt eines Diensts beschreiben.The description tree is the hierarchy of types (starting with the System.ServiceModel.Description.ServiceDescription class) that together describe every aspect of a service. Windows Communication Foundation (WCF) verwendet eine beschreibungsstruktur zum Erstellen einer gültigen Dienstlaufzeit, zum Veröffentlichen von Web Services Description Language (WSDL), XML-Schemadefinitionssprache (XSD) sowie Richtlinienassertionen (Metadaten) über den Dienst, mit denen Clients können Verbinden mit und verwenden Sie den Dienst und zum Generieren verschiedener Code- und konfigurationsdateidarstellungen der beschreibungsstrukturwerte.Windows Communication Foundation (WCF) uses a description tree to build a valid service runtime, to publish Web Services Description Language (WSDL), XML Schema definition language (XSD), and policy assertions (metadata) about the service that clients can use to connect to and use the service, and to generate various code and configuration file representations of the description tree values.

Dieses Thema beschreibt, wie vertragsbezogene Eigenschaften aus dem Dienstvertrag abgerufen, wie sie implementiert und der Beschreibungsstruktur hinzugefügt werden.This topic describes how contract-related properties are obtained from the service contract, and how they are implemented and added to the description tree. In einigen Fällen werden Attributwerte in Verhaltenseigenschaften umgewandelt, und das Verhalten wird dann in die Beschreibungsstruktur eingefügt.In some cases, attribute values are converted into behavior properties and behavior is then inserted into the description tree. Weitere Informationen dazu, wie der beschreibungsstrukturwerte in Metadaten umgewandelt werden, finden Sie unter ServiceDescription und WSDL-Verweis.For more information about how the description tree values are converted into metadata, see ServiceDescription and WSDL Reference.

Zuordnen von Vorgängen zur BeschreibungsstrukturMapping Operations to the Description Tree

In WCF-Anwendungen werden Dienstverträge nach Schnittstellen (oder Klassen) modelliert, die Attribute verwenden, um die Schnittstelle oder Klasse und ihre Methoden als eine vorgangsgruppierung zu markieren.In WCF applications, service contracts are modeled by interfaces (or classes) that use attributes to mark the interface or class and its methods as a grouping of operations. Wenn eine ServiceHost-Klasse geöffnet ist, werden Dienstverträge und Implementierungen immer wieder reflektiert und mit den Konfigurationsinformationen in eine Beschreibungsstruktur zusammengeführt.When a ServiceHost class is opened, any service contracts and implementations are reflected over and merged with configuration information into a description tree.

Es gibt zwei Typen von vorgangsmodellen: das Parameter Modell und die Nachrichtenvertrag Modell.There are two types of operation models: the parameter model and the message contract model. Das Parametermodell verwendet verwaltete Methoden, die keinen Parameter oder Rückgabewerttyp besitzen, der von der Klasse System.ServiceModel.MessageContractAttribute markiert wird.The parameter model uses managed methods that do not have a parameter or return value type that is marked by the System.ServiceModel.MessageContractAttribute class. In diesem Modell Entwickler Steuern der Serialisierung der Parameter und Rückgabewerte, aber WCF generiert die Werte, die verwendet werden, um die beschreibungsstruktur für den Dienst und seinen Vertrag zu füllen.In this model, developers control the serialization of parameters and return values, but WCF generates the values that are used to populate the description tree for the service and its contract.

In Konfigurationsdateien angegebene Bindungen werden direkt in die Eigenschaft ServiceEndpoint.Binding geladen.Bindings specified in configuration files are loaded directly into the ServiceEndpoint.Binding property.

ServiceBehaviorAttribute-EigenschaftServiceBehaviorAttribute Property Beschreibungsstrukturwert beeinflusstDescription Tree Value Affected
nameName Name
NamespaceNamespace Namespace
ConfigurationNameConfigurationName ConfigurationName
IgnoreExtensionDataObjectIgnoreExtensionDataObject Legt die Eigenschaft IgnoreExtensionDataObject für alle Vorgänge fest.Sets the IgnoreExtensionDataObject property for all operations.
MaxItemsInObjectGraphMaxItemsInObjectGraph Legt die Eigenschaft MaxItemsInObjectGraph für alle Vorgänge fest.Sets the MaxItemsInObjectGraph property for all operations.
ServiceContractAttribute-EigenschaftServiceContractAttribute Property Beschreibungsstrukturwert beeinflusstDescription Tree Value Affected
CallbackContractCallbackContract CallbackContractType, MessageDescription hat allen Operationen Messages hinzugefügt.CallbackContractType, MessageDescription added to all operations Messages.
ConfigurationNameConfigurationName ConfigurationName
ProtectionLevelProtectionLevel ProtectionLevel und möglicherweise untergeordnete Schutzebenen.ProtectionLevel and possibly child protection levels. Weitere Informationen über die Schutzebene Hierarchie finden Sie unter Verständnis Schutzebene.For more information about the protection-level hierarchy, see Understanding Protection Level.
SessionModeSessionMode SessionMode
ServiceKnownTypesAttribute-WertServiceKnownTypesAttribute Value Beschreibungsstrukturwert beeinflusstDescription Tree Value Affected
MethodNameMethodName KnownTypes
OperationContractAttribute-WertOperationContractAttribute Value Beschreibungsstrukturwert beeinflusstDescription Tree Value Affected
AktionAction Action für die Ausgabe- oder Eingabenachricht, abhängig vom Vertrag/Rückrufvertrag.Action for the output message or input message, depending upon contract/callback contract.
AsyncPatternAsyncPattern Wenn "true", BeginMethod und EndMethodIf true, BeginMethod and EndMethod
IsOneWayIsOneWay Wird einer einzelnen MessageDescription in Messages zugeordnetMaps to a single MessageDescription in Messages
IsInitiatingIsInitiating IsInitiating
IsTerminatingIsTerminating IsTerminating
nameName Name
ProtectionLevelProtectionLevel ProtectionLevel und möglicherweise untergeordnete Schutzebenen.ProtectionLevel and possibly child protection levels. Weitere Informationen über die Schutzebene Hierarchie finden Sie unter Verständnis Schutzebene.For more information about the protection-level hierarchy, see Understanding Protection Level.
ReplyActionReplyAction Action für die Ausgabe- oder Eingabenachricht, abhängig vom Vertrag/Rückrufvertrag.Action for the output message or input message, depending upon contract/callback contract.
FaultContractAttribute-WertFaultContractAttribute Value Beschreibungsstrukturwert beeinflusstDescription Tree Value Affected
AktionAction Action, abhängig vom Vertrag/Rückrufvertrag.Action depending upon contract/callback contract.
DetailTypeDetailType DetailType
nameName Name
NamespaceNamespace Namespace
ProtectionLevelProtectionLevel ProtectionLevel
DataContractFormatAttribute-WertDataContractFormatAttribute Value Beschreibungsstrukturwert beeinflusstDescription Tree Value Affected
MitUse Der Wert Style ist auf DataContractSerializerOperationBehavior für den Vorgang festgelegt.The Style value is set on the DataContractSerializerOperationBehavior for the operation.
XmlSerializerFormatAttribute-WertXmlSerializerFormatAttribute Value Beschreibungsstrukturwert beeinflusstDescription Tree Value Affected
StilStyle Diese XmlSerializerFormatAttribute-Eigenschaft ist auf XmlSerializerOperationBehavior für den Vorgang festgelegt.This XmlSerializerFormatAttribute property is set on the XmlSerializerOperationBehavior for the operation.
MitUse XmlSerializerFormatAttribute ist auf XmlSerializerOperationBehavior für den Vorgang festgelegt.The XmlSerializerFormatAttribute is set on the XmlSerializerOperationBehavior for the operation.
TransactionFlowAttribute-WertTransactionFlowAttribute Value Beschreibungsstrukturwert beeinflusstDescription Tree Value Affected
TransactionFlowOptionTransactionFlowOption TransactionFlowAttribute wird der Eigenschaft Behaviors als Vorgangsverhalten hinzugefügt.The TransactionFlowAttribute is added as an operation behavior to the Behaviors property.
MessageContractAttribute-WertMessageContractAttribute Value Beschreibungsstrukturwert beeinflusstDescription Tree Value Affected
ProtectionLevelProtectionLevel ProtectionLevel
WrapperNameWrapperName WrapperName
WrapperNamespaceWrapperNamespace WrapperNamespace
MessageHeaderAttribute-WertMessageHeaderAttribute Value Beschreibungsstrukturwert beeinflusstDescription Tree Value Affected
AkteurActor Actor für den entsprechenden Header in HeadersActor for the corresponding header in Headers
MustUnderstandMustUnderstand MustUnderstand für den entsprechenden Header in HeadersMustUnderstand for the corresponding header in Headers
nameName Name für den entsprechenden Header in HeadersName for the corresponding header in Headers
NamespaceNamespace Namespace für den entsprechenden Header in HeadersNamespace for the corresponding header in Headers
ProtectionLevelProtectionLevel ProtectionLevel für den entsprechenden Header in HeadersProtectionLevel for the corresponding header in Headers
RelayRelay Relay für den entsprechenden Header in HeadersRelay for the corresponding header in Headers
MessageBodyMemberAttribute-WertMessageBodyMemberAttribute Value Beschreibungsstrukturwert beeinflusstDescription Tree Value Affected
nameName Name für die entsprechende Stelle im PartsName for the corresponding part in Parts
NamespaceNamespace Namespace für die entsprechende Stelle im PartsNamespace for the corresponding part in Parts
ReihenfolgeOrder Index für die entsprechende Stelle im PartsIndex for the corresponding part in Parts
ProtectionLevelProtectionLevel ProtectionLevel für die entsprechende Stelle im PartsProtectionLevel for the corresponding part in Parts
MessageHeaderArrayAttribute-WertMessageHeaderArrayAttribute Value Beschreibungsstrukturwert beeinflusstDescription Tree Value Affected
AkteurActor Actor
MustUnderstandMustUnderstand MustUnderstand
nameName Name
NamespaceNamespace Namespace
ProtectionLevelProtectionLevel ProtectionLevel
RelayRelay Relay
MessagePropertyAttribute-WertMessagePropertyAttribute Value Beschreibungsstrukturwert beeinflusstDescription Tree Value Affected
nameName Name
MessageParameterAttribute-WertMessageParameterAttribute Value Beschreibungsstrukturwert beeinflusstDescription Tree Value Affected
nameName Name für die entsprechende Stelle im PartsName for the corresponding part in Parts

Weitere Informationen dazu, wie der beschreibungsstrukturwerte in Metadaten umgewandelt werden, finden Sie unter ServiceDescription und WSDL-Verweis.For more information about how the description tree values are converted into metadata, see ServiceDescription and WSDL Reference.

Siehe auchSee Also

ServiceDescription und WSDL-VerweisServiceDescription and WSDL Reference