SslStream.Write Metodo

Definizione

Spazio dei nomi:

System.Net.Security

Assembly:

System.Net.Security.dll

Scrive dati in questo flusso.

Overload

Write(Byte[])	Scrive i dati specificati in questo flusso.
Write(Byte[], Int32, Int32)	Consente di scrivere il numero specificato di Byte nel flusso sottostante, utilizzando il buffer e l'offset specificati.

Write(Byte[])

Origine:

SslStream.cs

Scrive i dati specificati in questo flusso.

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

public void Write (byte[] buffer);

override this.Write : byte[] -> unit

Public Sub Write (buffer As Byte())

Parametri

buffer

Byte[]

Matrice di Byte che fornisce i byte scritti nel flusso.

Eccezioni

ArgumentNullException

buffer è null.

IOException

Operazione di scrittura non riuscita.

NotSupportedException

È già in corso un'operazione di scrittura.

ObjectDisposedException

L'oggetto è stato chiuso.

InvalidOperationException

L'autenticazione non è stata effettuata.

Esempio

L'esempio di codice seguente illustra la scrittura in un oggetto autenticato SslStream.

static void ProcessClient( TcpClient^ client )
{
   
   // A client has connected. Create the 
   // SslStream using the client's network stream.
   SslStream^ sslStream = gcnew SslStream( client->GetStream(),false );
   
   // Authenticate the server but don't require the client to authenticate.
   try
   {
      sslStream->AuthenticateAsServer( serverCertificate, false, true );
      // false == no client cert required; true == check cert revocation.
      
      // 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( L"Waiting for client message..." );
      String^ messageData = ReadMessage( sslStream );
      Console::WriteLine( L"Received: {0}", messageData );
      
      // Write a message to the client.
      array<Byte>^message = Encoding::UTF8->GetBytes( L"Hello from the server.<EOF>" );
      Console::WriteLine( L"Sending hello message." );
      sslStream->Write( message );
   }
   catch ( AuthenticationException^ e ) 
   {
      Console::WriteLine( L"Exception: {0}", e->Message );
      if ( e->InnerException != nullptr )
      {
         Console::WriteLine( L"Inner exception: {0}", e->InnerException->Message );
      }
      Console::WriteLine( L"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();
   }

}

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

Commenti

Questo metodo blocca mentre l'operazione viene completata. Per impedire il blocco durante il completamento dell'operazione, usare il BeginWrite metodo .

Non è possibile chiamare questo metodo fino a quando non è stata eseguita correttamente l'autenticazione. Per eseguire l'autenticazioneAuthenticateAsClient, chiamare uno dei metodi , o BeginAuthenticateAsClientAuthenticateAsServer, BeginAuthenticateAsServer .

La SslStream classe non supporta più operazioni di scrittura simultanee.

Write(Byte[], Int32, Int32)

Origine:

SslStream.cs

Consente di scrivere il numero specificato di Byte nel flusso sottostante, utilizzando il buffer e l'offset specificati.

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)

Parametri

buffer

Byte[]

Matrice di Byte che fornisce i byte scritti nel flusso.

offset

Int32

Valore Int32 contenente la posizione a base zero nel parametro buffer in corrispondenza del quale iniziare la lettura dei byte che devono essere scritti nel flusso.

count

Int32

Valore Int32 contenente il numero di byte da leggere dal buffer.

Eccezioni

ArgumentNullException

buffer è null.

ArgumentException

offset è minore di zero.

-oppure-

offset è maggiore della lunghezza di buffer.

-oppure-

La somma di offset e conteggio è maggiore della lunghezza del buffer.

IOException

Operazione di scrittura non riuscita.

NotSupportedException

È già in corso un'operazione di scrittura.

ObjectDisposedException

L'oggetto è stato chiuso.

InvalidOperationException

L'autenticazione non è stata effettuata.

Commenti

Questo metodo blocca mentre l'operazione viene completata. Per impedire il blocco mentre l'operazione completa l'operazione, usare il BeginWrite metodo .

Non è possibile chiamare questo metodo fino a quando non è stata eseguita correttamente l'autenticazione. Per eseguire l'autenticazioneAuthenticateAsClient, chiamare uno dei metodi , o BeginAuthenticateAsClientAuthenticateAsServer, BeginAuthenticateAsServer .

La SslStream classe non supporta più operazioni di scrittura simultanee.