BodyWriter Classe

Definizione

Spazio dei nomi:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Rappresenta il writer del corpo del messaggio.

public ref class BodyWriter abstract

public abstract class BodyWriter

type BodyWriter = class

Public MustInherit Class BodyWriter

Ereditarietà

Object

BodyWriter

Derivato

System.ServiceModel.Channels.StreamBodyWriter

System.ServiceModel.Security.WSTrustRequestBodyWriter

System.ServiceModel.Security.WSTrustResponseBodyWriter

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();
        }
    }
}

Imports System.Text
Imports System.ServiceModel
Imports System.ServiceModel.Channels
Imports System.Xml

Namespace UEBodyWriter
    Friend Class MyBodyWriter
        Inherits BodyWriter
        Private Const textTag As String = "text"
        Private bodySegment() As String

        Public Sub New(ByVal strData() As String)
            MyBase.New(True)
            Dim length = strData.Length

            Me.bodySegment = New String(length - 1){}
            For i = 0 To length - 1
                Me.bodySegment(i) = strData(i)
            Next i
        End Sub

        Protected Overrides Sub OnWriteBodyContents(ByVal writer As XmlDictionaryWriter)
           writer.WriteStartElement(textTag)

            For Each str As String In bodySegment
                writer.WriteString(str)
            Next str

            writer.WriteEndElement()
        End Sub
    End Class

    Module Module1
        Sub Main(ByVal args() As String)
            Dim strings() As String = {"Hello", "world"}
            Dim bw As New MyBodyWriter(strings)

            Dim strBuilder As New StringBuilder(10)
            Dim writer = XmlWriter.Create(strBuilder)
            Dim dictionaryWriter = XmlDictionaryWriter.CreateDictionaryWriter(writer)

            bw.WriteBodyContents(dictionaryWriter)
            dictionaryWriter.Flush()
        End Sub
    End Module
End Namespace

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.