WebMessageEncodingBindingElement WebMessageEncodingBindingElement WebMessageEncodingBindingElement WebMessageEncodingBindingElement Class

Definizione

Consente alle codifiche di messaggi XML di testo normale e JSON (JavaScript Object Notation) e al contenuto binario "non elaborato" di essere letti e scritti quando vengono usati in un'associazione Windows Communication Foundation (WCF).Enables plain-text XML, JavaScript Object Notation (JSON) message encodings and "raw" binary content to be read and written when used in a Windows Communication Foundation (WCF) binding.

public ref class WebMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement, System::ServiceModel::Description::IWsdlExportExtension
public sealed class WebMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IWsdlExportExtension
type WebMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
    interface IWsdlExportExtension
Public NotInheritable Class WebMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IWsdlExportExtension
Ereditarietà
Implementazioni

Commenti

La codifica è il processo di trasformazione di un messaggio in una sequenza di byte.Encoding is the process of transforming a message into a sequence of bytes. La decodifica è il processo inverso.Decoding is the reverse process. Questi processi richiedono la specifica di una codifica caratteri.These processes require the specification of a character encoding. WebMessageEncodingBindingElement delega a una serie di codificatori interni per gestire le codifiche XML di testo normale e JSON e i dati binari "non elaborati".The WebMessageEncodingBindingElement works by delegating to a series of inner encoders to handle the plain-text XML and JSON encodings, and "raw" binary data. Questa delega viene eseguita mediante un codificatore di messaggi composto.This delegation is done by a composite message encoder.

Questo elemento di associazione e il relativo codificatore composto vengono utilizzati per controllare la codifica in scenari che non utilizzano la messaggistica SOAP utilizzata da WebHttpBinding.This binding element and its composite encoder are used to control the encoding in scenarios that do not use SOAP messaging used by the WebHttpBinding. Questi scenari includono POX (Plain Old XML), REST (Representational State Transfer), RSS (Really Simple Syndication ) e AJAX (Atom syndication and Asynchronous JavaScript and XML).These scenarios include "Plain Old XML" (POX), Representational State Transfer (REST), Really Simple Syndication (RSS) and Atom syndication, and Asynchronous JavaScript and XML (AJAX). Il codificatore di messaggi composto non supporta SOAP o WS-Addressing, pertanto MessageVersion restituisce sempre None.The composite message encoder does not support SOAP or WS-Addressing, and so MessageVersion always returns None.

L'elemento di associazione può essere configurato con una codifica di caratteri di scrittura al momento della costruzione utilizzando il costruttore WebMessageEncodingBindingElement(Encoding).The binding element can be configured with a write character encoding at construction time using the WebMessageEncodingBindingElement(Encoding) constructor. Il valore Encoding specifica il comportamento in scrittura per le codifiche JSON e XML di testo.The Encoding value specifies the behavior on write for the JSON and Textual XML cases. In lettura viene interpretata qualsiasi codifica di messaggi e codifica di testo valida.On read, any valid message encoding and text encoding is understood.

Questo costruttore imposta valori predefiniti per il numero massimo di lettori e writer allocati ai pool e che sono disponibili per elaborare rispettivamente messaggi in arrivo e messaggi in uscita senza allocare nuovi lettori o writer.This constructor sets default values on the maximum number of readers and writers that are allocated to pools and that are respectively available to process incoming and outgoing messages without allocating new readers or writers. Le proprietà MaxReadPoolSize e MaxWritePoolSize possono inoltre essere utilizzate per impostare rispettivamente il numero massimo di lettori e il numero massimo di writer da allocare.The properties MaxReadPoolSize and MaxWritePoolSize can also be used to set the maximum number of readers and writers to be allocated respectively. Per impostazione predefinita vengono allocati 64 lettori e 16 writer.By default 64 readers and 16 writers are allocated.

Vincoli di complessità predefiniti vengono inoltre impostati da questo costruttore nella classe XmlDictionaryReaderQuotas associata a questa codifica mediante la proprietà ReaderQuotas per fornire protezione da una classe di attacchi di tipo Denial of Service (DoS) che tentano di utilizzare la complessità dei messaggi per bloccare le risorse di elaborazione dell'endpoint.Default complexity constraints are also set by this constructor on the XmlDictionaryReaderQuotas associated with this encoding by the ReaderQuotas property to protect against a class of denial of service (DOS) attacks that attempt to use message complexity to tie up endpoint processing resources.

WebMessageEncodingBindingElement ha un metodo CreateMessageEncoderFactory che crea una factory di codificatori di messaggi che produce decodificatori e codificatori di messaggi JSON, XML o non elaborati in base al tipo di contenuto specificato.The WebMessageEncodingBindingElement has a CreateMessageEncoderFactory method that creates a message encoder factory that produces JSON, XML or Raw message decoders and encoders as appropriate depending on the content type specified.

WebMessageEncodingBindingElement fornisce anche i metodi per compilare le factory e i listener per i canali attraverso i quali vengono propagate le richieste HTTP.The WebMessageEncodingBindingElement also provides the methods to build the factories and listeners for the channels through which the HTTP requests flow.

Il codificatore composto e i relativi componenti di configurazione e classi associate possono essere utilizzati in contesti con attendibilità parziale, nel qual caso non richiedono autorizzazioni speciali.The composite encoder and its associated classes and configuration components are usable in partial trust and this use does not require any special permissions.

Costruttori

WebMessageEncodingBindingElement() WebMessageEncodingBindingElement() WebMessageEncodingBindingElement() WebMessageEncodingBindingElement()

Inizializza una nuova istanza della classe WebMessageEncodingBindingElement.Initializes a new instance of the WebMessageEncodingBindingElement class.

WebMessageEncodingBindingElement(Encoding) WebMessageEncodingBindingElement(Encoding) WebMessageEncodingBindingElement(Encoding) WebMessageEncodingBindingElement(Encoding)

Inizializza una nuova istanza della classe WebMessageEncodingBindingElement con una codifica dei caratteri di scrittura specificata.Initializes a new instance of the WebMessageEncodingBindingElement class with a specified write character encoding.

Proprietà

ContentTypeMapper ContentTypeMapper ContentTypeMapper ContentTypeMapper

Ottiene o imposta il modo in cui il tipo di contenuto di un messaggio in arrivo viene mappato a un formato.Gets or sets how the content type of an incoming message is mapped to a format.

CrossDomainScriptAccessEnabled CrossDomainScriptAccessEnabled CrossDomainScriptAccessEnabled CrossDomainScriptAccessEnabled

Ottiene o imposta un valore che determina se l'accesso allo script tra domini è abilitato.Gets or sets a value that determines if cross domain script access is enabled.

MaxReadPoolSize MaxReadPoolSize MaxReadPoolSize MaxReadPoolSize

Ottiene o imposta un valore che specifica il numero massimo di lettori allocati a un pool e disponibili per l'elaborazione di messaggi in arrivo senza allocare nuovi lettori.Gets or sets a value that specifies the maximum number of readers that is allocated to a pool and that is available to process incoming messages without allocating new readers.

MaxWritePoolSize MaxWritePoolSize MaxWritePoolSize MaxWritePoolSize

Ottiene o imposta un valore che specifica il numero massimo di writer allocati a un pool e disponibili per l'elaborazione di messaggi in uscita senza allocare nuovi writer.Gets or sets a value that specifies the maximum number of writers that is allocated to a pool and that is available to process outgoing messages without allocating new writers.

MessageVersion MessageVersion MessageVersion MessageVersion

Ottiene o imposta la versione del messaggio che indica che l'elemento di associazione non utilizza SOAP né WS-Addressing.Gets or sets the message version that indicates that the binding element does not use SOAP or WS-Addressing.

ReaderQuotas ReaderQuotas ReaderQuotas ReaderQuotas

Ottiene vincoli sulla complessità dei messaggi SOAP che possono essere elaborati da endpoint configurati con questa associazione.Gets constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding.

WriteEncoding WriteEncoding WriteEncoding WriteEncoding

Ottiene o imposta la codifica dei caratteri utilizzata per scrivere il testo dei messaggi.Gets or sets the character encoding that is used to write the message text.

Metodi

BuildChannelFactory<TChannel>(BindingContext) BuildChannelFactory<TChannel>(BindingContext) BuildChannelFactory<TChannel>(BindingContext) BuildChannelFactory<TChannel>(BindingContext)

Compila lo stack della channel factory nel client che crea un tipo di canale specificato per un contesto specificato.Builds the channel factory stack on the client that creates a specified type of channel for a specified context.

BuildChannelListener<TChannel>(BindingContext) BuildChannelListener<TChannel>(BindingContext) BuildChannelListener<TChannel>(BindingContext) BuildChannelListener<TChannel>(BindingContext)

Compila lo stack del listener del canale nel client che accetta un tipo di canale specificato per un contesto specificato.Builds the channel listener stack on the client that accepts a specified type of channel for a specified context.

CanBuildChannelFactory<TChannel>(BindingContext) CanBuildChannelFactory<TChannel>(BindingContext) CanBuildChannelFactory<TChannel>(BindingContext) CanBuildChannelFactory<TChannel>(BindingContext)

Restituisce un valore che indica se l'elemento di associazione può compilare una channel factory per un tipo di canale specifico.Returns a value that indicates whether the binding element can build a channel factory for a specific type of channel.

(Inherited from BindingElement)
CanBuildChannelListener<TChannel>(BindingContext) CanBuildChannelListener<TChannel>(BindingContext) CanBuildChannelListener<TChannel>(BindingContext) CanBuildChannelListener<TChannel>(BindingContext)

Restituisce un valore che indica se l'associazione corrente può compilare un listener per un tipo di canale e di contesto specificati.Returns a value that indicates whether the current binding can build a listener for a specified type of channel and context.

Clone() Clone() Clone() Clone()

Crea un nuovo oggetto WebMessageEncodingBindingElement inizializzato da quello corrente.Creates a new WebMessageEncodingBindingElement object initialized from the current one.

CreateMessageEncoderFactory() CreateMessageEncoderFactory() CreateMessageEncoderFactory() CreateMessageEncoderFactory()

Crea una factory di codificatori di messaggi che produce codificatori di messaggi che possono scrivere messaggi JSON (JavaScript Object Notation) o XML.Creates a message encoder factory that produces message encoders that can write either JavaScript Object Notation (JSON) or XML messages.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetProperty<T>(BindingContext) GetProperty<T>(BindingContext) GetProperty<T>(BindingContext) GetProperty<T>(BindingContext)

Restituisce l'oggetto del tipo necessario, se presente, dal livello appropriato nello stack del canale oppure, se l'oggetto non è presente, restituisce null.Returns the object of the type requested, if present, from the appropriate layer in the channel stack, or null if it is not present.

GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

IWmiInstanceProvider.FillInstance(IWmiInstance) IWmiInstanceProvider.FillInstance(IWmiInstance) IWmiInstanceProvider.FillInstance(IWmiInstance) IWmiInstanceProvider.FillInstance(IWmiInstance)
IWmiInstanceProvider.GetInstanceType() IWmiInstanceProvider.GetInstanceType() IWmiInstanceProvider.GetInstanceType() IWmiInstanceProvider.GetInstanceType()
IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

Genera informazioni di contratto WSDL da criteri di codifica contenuti nell'elemento di associazione.Generates WSDL contract information from encoding policies contained in the binding element.

IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

Genera informazioni di contratto WSDL da criteri di codifica contenuti nell'elemento di associazione.Generates WSDL contract information from encoding policies contained in the binding element.

Si applica a