SslStream.Write Metódus

Definíció

Névtér:: System.Net.Security

Szerelvény:: System.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Adatokat ír ebbe a streambe.

Túlterhelések

Name	Description
Write(Byte[])	A megadott adatokat a streambe írja.
Write(Byte[], Int32, Int32)	Írja be a megadott számú Bytes-t a mögöttes streambe a megadott puffer és eltolás használatával.

Write(Byte[])

A megadott adatokat a streambe írja.

public:
 void Write(cli::array <System::Byte> ^ buffer);

public void Write(byte[] buffer);

override this.Write : byte[] -> unit

Public Sub Write (buffer As Byte())

Paraméterek

buffer: Byte[]

A Byte streambe írt bájtokat tartalmazó tömb.

Kivételek

ArgumentNullException

buffer az null.

IOException

Az írási művelet nem sikerült.

NotSupportedException

Már folyamatban van egy írási művelet.

ObjectDisposedException

Ezt az objektumot bezárták.

InvalidOperationException

A hitelesítés nem történt meg.

Példák

Az alábbi példakód egy hitelesített fájlba való írást SslStreammutatja be.

static void ProcessClient (TcpClient client)
{
    // A client has connected. Create the
    // SslStream using the client's network stream.
    SslStream sslStream = new SslStream(
        client.GetStream(), false);
    // Authenticate the server but don't require the client to authenticate.
    try
    {
        sslStream.AuthenticateAsServer(serverCertificate, clientCertificateRequired: false, checkCertificateRevocation: true);

        // Display the properties and settings for the authenticated stream.
        DisplaySecurityLevel(sslStream);
        DisplaySecurityServices(sslStream);
        DisplayCertificateInformation(sslStream);
        DisplayStreamProperties(sslStream);

        // Set timeouts for the read and write to 5 seconds.
        sslStream.ReadTimeout = 5000;
        sslStream.WriteTimeout = 5000;
        // Read a message from the client.
        Console.WriteLine("Waiting for client message...");
        string messageData = ReadMessage(sslStream);
        Console.WriteLine("Received: {0}", messageData);

        // Write a message to the client.
        byte[] message = Encoding.UTF8.GetBytes("Hello from the server.<EOF>");
        Console.WriteLine("Sending hello message.");
        sslStream.Write(message);
    }
    catch (AuthenticationException e)
    {
        Console.WriteLine("Exception: {0}", e.Message);
        if (e.InnerException != null)
        {
            Console.WriteLine("Inner exception: {0}", e.InnerException.Message);
        }
        Console.WriteLine ("Authentication failed - closing the connection.");
        sslStream.Close();
        client.Close();
        return;
    }
    finally
    {
        // The client stream will be closed with the sslStream
        // because we specified this behavior when creating
        // the sslStream.
        sslStream.Close();
        client.Close();
    }
}

Private Shared Sub ProcessClient(client As TcpClient)
    ' A client has connected. Create the 
    ' SslStream using the client's network stream.
    Dim sslStream = New SslStream(client.GetStream(), False)

    Try

        sslStream.AuthenticateAsServer(serverCertificate, clientCertificateRequired:=False, checkCertificateRevocation:=True)
        ' Display the properties And settings for the authenticated stream.
        DisplaySecurityLevel(sslStream)
        DisplaySecurityServices(sslStream)
        DisplayCertificateInformation(sslStream)
        DisplayStreamProperties(sslStream)

        ' Set timeouts for the read and write to 5 seconds.
        sslStream.ReadTimeout = 5000
        sslStream.WriteTimeout = 5000

        ' Read a message from the client.   
        Console.WriteLine("Waiting for client message...")
        Dim messageData As String = ReadMessage(sslStream)
        Console.WriteLine("Received: {0}", messageData)

        ' Write a message to the client.
        Dim message As Byte() = Encoding.UTF8.GetBytes("Hello from the server.<EOF>")
        Console.WriteLine("Sending hello message.")
        sslStream.Write(message)
    Catch e As AuthenticationException
        Console.WriteLine("Exception: {0}", e.Message)

        If e.InnerException IsNot Nothing Then
            Console.WriteLine("Inner exception: {0}", e.InnerException.Message)
        End If

        Console.WriteLine("Authentication failed - closing the connection.")
        sslStream.Close()
        client.Close()
        Return
    Finally
        ' The client stream will be closed with the sslStream
        ' because we specified this behavior when creating
        ' the sslStream.
        sslStream.Close()
        client.Close()
    End Try
End Sub

Megjegyzések

Ez a metódus blokkolja a művelet befejeződése közben. Ha meg szeretné akadályozni, hogy a művelet befejeződjön, használja a metódust BeginWrite .

Ezt a metódust csak a sikeres hitelesítés után hívhatja meg. Az egyik metódus BeginAuthenticateAsClient AuthenticateAsServer BeginAuthenticateAsServer meghívásának AuthenticateAsClienthitelesítéséhez.

Az SslStream osztály nem támogatja több egyidejű írási műveletet.

A következőre érvényes:

Write(Byte[], Int32, Int32)

Írja be a megadott számú Bytes-t a mögöttes streambe a megadott puffer és eltolás használatával.

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

public override void Write(byte[] buffer, int offset, int count);

override this.Write : byte[] * int * int -> unit

Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Paraméterek

buffer: Byte[]

A Byte streambe írt bájtokat tartalmazó tömb.

offset: Int32

Az Int32 a nulla alapú hely buffer , ahol a streambe írandó bájtok olvasása elkezdhető.

count: Int32

A Int32 (z) az olvasási bufferbájtok számát tartalmazza.

Kivételek

ArgumentNullException

buffer az null.

ArgumentException

offset kisebb, mint nulla.

-vagy-

offset nagyobb, mint a hossza buffer.