NegotiateStream.Write(Byte[], Int32, Int32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Écrivez le nombre spécifié de Bytes dans le flux sous-jacent à l’aide de la mémoire tampon et du décalage spécifiés.
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ètres
- offset
- Int32
Contenant Int32 l’emplacement de base zéro dans buffer lequel commencer la lecture d’octets à écrire dans le flux.
Exceptions
buffer a la valeur null.
offset est inférieur à 0.
-ou-
offset est supérieur à la longueur de buffer.
-ou-
offset plus le nombre est supérieur à la longueur de buffer.
Échec de l’opération d’écriture.
-ou-
Le chiffrement est en cours d’utilisation, mais les données n’ont pas pu être chiffrées.
Il existe déjà une opération d’écriture en cours.
Cet objet a été fermé.
L’authentification n’a pas eu lieu.
Exemples
L’exemple de code suivant illustre l’écriture dans un NegotiateStream.
public static void Main(String[] args)
{
// Establish the remote endpoint for the socket.
// For this example, use the local machine.
IPHostEntry ipHostInfo = Dns.GetHostEntry(Dns.GetHostName());
IPAddress ipAddress = ipHostInfo.AddressList[0];
// Client and server use port 11000.
IPEndPoint remoteEP = new IPEndPoint(ipAddress,11000);
// Create a TCP/IP socket.
TcpClient client = new TcpClient();
// Connect the socket to the remote endpoint.
client.Connect(remoteEP);
Console.WriteLine("Client connected to {0}.",
remoteEP.ToString());
// Ensure the client does not close when there is
// still data to be sent to the server.
client.LingerState = (new LingerOption(true,0));
// Request authentication.
NetworkStream clientStream = client.GetStream();
NegotiateStream authStream = new NegotiateStream(clientStream);
// Request authentication for the client only (no mutual authentication).
// Authenicate using the client's default credetials.
// Permit the server to impersonate the client to access resources on the server only.
// Request that data be transmitted using encryption and data signing.
authStream.AuthenticateAsClient(
(NetworkCredential) CredentialCache.DefaultCredentials,
"",
ProtectionLevel.EncryptAndSign,
TokenImpersonationLevel.Impersonation);
DisplayAuthenticationProperties(authStream);
DisplayStreamProperties(authStream);
if (authStream.CanWrite)
{
// Encode the test data into a byte array.
byte[] message = System.Text.Encoding.UTF8.GetBytes("Hello from the client.");
authStream.Write(message, 0, message.Length);
authStream.Flush();
Console.WriteLine("Sent {0} bytes.", message.Length);
}
// Close the client connection.
authStream.Close();
Console.WriteLine("Client closed.");
}
Remarques
Si le chiffrement, la signature ou le chiffrement et la signature sont activés, cette méthode lit les données à partir de la mémoire tampon, chiffre, chiffre, chiffre ou chiffre et les signe et les transmet à l’aide du flux sous-jacent. Si aucun service de sécurité, tel que le chiffrement de données ou la signature, n’est utilisé, cette méthode appelle Write sur le flux sous-jacent.
Cette méthode bloque la fin de l’opération d’écriture. Pour empêcher le blocage pendant la fin de l’opération, utilisez la WriteAsync méthode.
Vous ne pouvez pas appeler cette méthode tant que vous n’avez pas correctement authentifié. Pour s’authentifier, appelez l’une AuthenticateAsClientdes méthodes ,BeginAuthenticateAsServerAuthenticateAsClientAsyncBeginAuthenticateAsClientAuthenticateAsServerAuthenticateAsServerAsync
La NegotiateStream classe ne prend pas en charge plusieurs opérations d’écriture simultanées. Si vous tentez de démarrer une opération d’écriture alors qu’une autre opération d’écriture est déjà en cours d’exécution sur le même flux, une NotSupportedException exception est levée.