NetworkStream.CanWrite Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets a value that indicates whether the NetworkStream supports writing.

Namespace:   System.Net.Sockets
Assembly:  System (in System.dll)

public override bool CanWrite { get; }

Property Value

Type: System.Boolean

true if data can be written to the NetworkStream; otherwise, false. The default value is true.

If CanWrite is true, NetworkStream allows calls to the Write method. Provide the appropriate FileAccess enumerated value in the constructor to set the readability and writability of the NetworkStream. The CanWrite property is set when the NetworkStream is initialized.

The following code example checks CanWrite to verify that the NetworkStream is writable. It then performs a write operation on the NetworkStream.

// Examples for CanWrite, and CanWrite  

// Check to see if this NetworkStream is writable.
if (myNetworkStream.CanWrite){

     byte[] myWriteBuffer = Encoding.ASCII.GetBytes("Are you receiving this message?");
     myNetworkStream.Write(myWriteBuffer, 0, myWriteBuffer.Length);
}
else{
     Console.WriteLine("Sorry.  You cannot write to this NetworkStream.");  
}

.NET Framework
Available since 1.1
Return to top
Show: