BodyWriter Classe

Definizione

Rappresenta il writer del corpo del messaggio.

public abstract class BodyWriter
Ereditarietà
BodyWriter
Derivato

Esempio

Nell'esempio seguente viene illustrato come derivare una classe da BodyWriter. Questo override prende una matrice di stringhe e le scrive in un XmlDictionaryWriter.

using System;
using System.Text;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.Xml;

namespace UEBodyWriter
{
    class MyBodyWriter : BodyWriter
    {
        const string textTag = "text";
        string[] bodySegment;

        public MyBodyWriter(string[] strData) : base(true)
        {
            int length = strData.Length;

            this.bodySegment = new string[length];
            for (int i = 0; i < length; i++)
            {
                this.bodySegment[i] = strData[i];
            }
        }

        protected override void OnWriteBodyContents(XmlDictionaryWriter writer)
        {
           writer.WriteStartElement(textTag);

           foreach (string str in bodySegment)
           {
               writer.WriteString(str);
           }

            writer.WriteEndElement();
        }
    }

    class Program
    {
        static void Main(string[] args)
        {
            string[] strings = {"Hello", "world"};
            MyBodyWriter bw = new MyBodyWriter(strings);

            StringBuilder strBuilder = new StringBuilder(10);
            XmlWriter writer = XmlWriter.Create(strBuilder);
            XmlDictionaryWriter dictionaryWriter = XmlDictionaryWriter.CreateDictionaryWriter(writer);

            bw.WriteBodyContents(dictionaryWriter);
            dictionaryWriter.Flush();
        }
    }
}

Commenti

Un messaggio è costituito da intestazioni e da un corpo. Le intestazioni vengono memorizzate nel buffer e il corpo viene inviato in un flusso. Dato che il corpo viene inviato in un flusso, l'utente non può passare il contenuto effettivo del corpo a un messaggio. Deve invece passare una classe che sa come scrivere il corpo quando viene chiesto di farlo. A tale fine, passare una classe derivata da BodyWriter a Message. Un messaggio chiama la classe derivata da BodyWriter ogni volta che richiede che il corpo venga scritto utilizzando un XmlWriter.

Costruttori

BodyWriter(Boolean)

Inizializza una nuova istanza della classe BodyWriter che indica in modo esplicito se memorizzare nel buffer.

Proprietà

IsBuffered

Ottiene un valore che indica se il metodo di scrittura può essere chiamato più volte.

Metodi

BeginWriteBodyContents(XmlDictionaryWriter, AsyncCallback, Object)

Avvia la scrittura del contenuto del corpo per il body writer con il writer, il callback e lo stato specificati.

CreateBufferedCopy(Int32)

Crea una copia del corpo memorizzata nel buffer.

EndWriteBodyContents(IAsyncResult)

Termina la scrittura del contenuto del corpo.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
OnBeginWriteBodyContents(XmlDictionaryWriter, AsyncCallback, Object)

Genera un evento quando il writer del corpo avvia la scrittura del contenuto del corpo con il writer, il callback e lo stato specificati.

OnCreateBufferedCopy(Int32)

Fornisce un punto di estensibilità quando viene scritto il contenuto del corpo.

OnEndWriteBodyContents(IAsyncResult)

Genera un evento quando il writer del corpo termina la scrittura del contenuto del corpo.

OnWriteBodyContents(XmlDictionaryWriter)

Se implementato, fornisce un punto di estendibilità quando viene scritto il contenuto del corpo.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
WriteBodyContents(XmlDictionaryWriter)

Scrive il contenuto del corpo del messaggio.

Si applica a

Prodotto Versioni
.NET Core 1.0, Core 1.1, 8 (package-provided), 9 (package-provided)
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
UWP 10.0