MessageVersion Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Specifica le versioni di SOAP e WS-Addressing associate a un messaggio e al relativo scambio.
public ref class MessageVersion sealed
public sealed class MessageVersion
[System.ComponentModel.TypeConverter(typeof(System.ServiceModel.Configuration.MessageVersionConverter))]
public sealed class MessageVersion
type MessageVersion = class
[<System.ComponentModel.TypeConverter(typeof(System.ServiceModel.Configuration.MessageVersionConverter))>]
type MessageVersion = class
Public NotInheritable Class MessageVersion
- Ereditarietà
-
MessageVersion
- Attributi
Commenti
MessageVersion Contiene le informazioni sul controllo delle versioni sia sulla soap envelope che sul protocollo di indirizzamento utilizzato da un messaggio. Un'istanza di Message è associata alla creazione a un oggetto specifico MessageVersion passando la versione come parametro in uno degli CreateMessage overload.
Tutte le proprietà statiche "get" in questa classe, ad esempio Soap11WSAddressing10 e Soap12 hanno semantica simile all'enumerazione. Forniscono un'enumerazione delle possibili versioni dei messaggi supportate dal runtime di Windows Communication Foundation (WCF). Un messaggio ha una struttura envelope e una struttura di indirizzamento. MessageVersion è solo un collegamento per fornire {EnvelopeVersion, AddressingVersion} insieme.
Attualmente sono disponibili due versioni soap envelope: SOAP 1.1 e SOAP 1.2. Queste versioni di SOAP sono rappresentate da EnvelopeVersion e vengono restituite dalle Soap11 proprietà e Soap12 . La versione di SOAP associata a MessageVersion può essere recuperata tramite la Envelope proprietà . Per altre informazioni, vedere lo schema per SOAP 1.1 e SOAP 1.2.
Attualmente sono disponibili due versioni di WS-Addressing. Quello inviato il 10 agosto 2004 e quello specificato nel protocollo WS-Addressing 1.0. La versione dell'indirizzo utilizzata dalla versione del messaggio corrente può essere recuperata utilizzando la Addressing proprietà . Queste versioni di WS-Addressing sono rappresentate da AddressingVersion e vengono restituite dalle WSAddressingAugust2004 proprietà e WSAddressing10 . Il WS-Addressing agosto 2004 viene conservato come valore legacy. Il 10 agosto 2004 W3C Member Submission for WS-Addressing è disponibile in Web Services Addressing (WS-Addressing). Il 17 agosto 2005 W3C Candidate Recommendation for WS-Addressing 1.0 - Core è disponibile in Web Services Addressing 1.0 - Core.
None fornisce supporto per l'uso della messaggistica in stile POX (plain old XML). L'abilitazione della messaggistica POX di base è ora una questione di configurazione di un'associazione HTTP nel servizio con un codificatore di testo che usa None.
Gli oggetti versione del messaggio possono essere creati usando versioni specificate di WS-Addressing e SOAP usando uno degli CreateVersion overload.
Proprietà
| Nome | Descrizione |
|---|---|
| Addressing |
Ottiene o imposta la versione di WS-Addressing associata alla versione del messaggio corrente. |
| Default |
Ottiene la versione del messaggio predefinita utilizzata da Windows Communication Foundation (WCF). |
| Envelope |
Ottiene la versione SOAP associata alla versione del messaggio corrente. |
| None |
Ottiene la versione del messaggio che non usa SOAP o WS-Addressing. |
| Soap11 |
Ottiene la versione del messaggio utilizzando SOAP 1.1. |
| Soap11WSAddressing10 |
Ottiene la versione del messaggio utilizzando WS-Addressing 1.0 e SOAP 1.1. |
| Soap11WSAddressingAugust2004 |
Ottiene la versione del messaggio utilizzando WS-Addressing inviato il 10 agosto 2004 e SOAP 1.1. |
| Soap12 |
Ottiene la versione del messaggio utilizzando SOAP 1.2. |
| Soap12WSAddressing10 |
Ottiene la versione del messaggio utilizzando WS-Addressing 1.0 e SOAP 1.2. |
| Soap12WSAddressingAugust2004 |
Ottiene la versione del messaggio utilizzando WS-Addressing inviato agosto 2004 e SOAP 1.2. |
Metodi
| Nome | Descrizione |
|---|---|
| CreateVersion(EnvelopeVersion, AddressingVersion) |
Crea un oggetto versione del messaggio con le versioni SOAP e WS-Addressing specificate. |
| CreateVersion(EnvelopeVersion) |
Crea un oggetto versione del messaggio utilizzando WS-Addressing 1.0 e con una versione SOAP specificata. |
| Equals(Object) |
Restituisce un valore che indica se la versione del messaggio corrente è uguale a un oggetto specificato. |
| GetHashCode() |
Ottiene un codice hash per la versione del messaggio corrente. |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| ToString() |
Restituisce la rappresentazione di stringa della versione del messaggio corrente. |