NetworkStream Конструкторы

Определение

Создает новый экземпляр класса NetworkStream.Creates a new instance of the NetworkStream class.

Перегрузки

NetworkStream(Socket)

Создает новый экземпляр класса NetworkStream для указанного объекта Socket.Creates a new instance of the NetworkStream class for the specified Socket.

NetworkStream(Socket, Boolean)

Инициализирует новый экземпляр класса NetworkStream для указанного объекта Socket с заданным правом на владение Socket.Initializes a new instance of the NetworkStream class for the specified Socket with the specified Socket ownership.

NetworkStream(Socket, FileAccess)

Создает новый экземпляр класса NetworkStream для указанного объекта Socket с заданными правами на доступ.Creates a new instance of the NetworkStream class for the specified Socket with the specified access rights.

NetworkStream(Socket, FileAccess, Boolean)

Создает новый экземпляр класса NetworkStream для указанного объекта Socket с заданными правами доступа и указанными правами владения объектом Socket.Creates a new instance of the NetworkStream class for the specified Socket with the specified access rights and the specified Socket ownership.

NetworkStream(Socket)

Создает новый экземпляр класса NetworkStream для указанного объекта Socket.Creates a new instance of the NetworkStream class for the specified Socket.

public:
 NetworkStream(System::Net::Sockets::Socket ^ socket);
public NetworkStream (System.Net.Sockets.Socket socket);
new System.Net.Sockets.NetworkStream : System.Net.Sockets.Socket -> System.Net.Sockets.NetworkStream
Public Sub New (socket As Socket)

Параметры

socket
Socket

Объект Socket, который будет использоваться NetworkStream для отправки и приема данных.The Socket that the NetworkStream will use to send and receive data.

Исключения

Параметр socket содержит значение null.The socket parameter is null.

Параметр socket не используется.The socket parameter is not connected.

-или--or- Свойство SocketType параметра socket не содержит значения Stream.The SocketType property of the socket parameter is not Stream.

-или--or- Параметр socket находится в неблокирующем состоянии.The socket parameter is in a nonblocking state.

Примеры

В следующем примере кода показано, как создать NetworkStream с Socket.The following code example illustrates how to create a NetworkStream with a Socket.

// Examples for constructors that do not specify file permission.
// Create the NetworkStream for communicating with the remote host.
NetworkStream^ myNetworkStream;

if ( networkStreamOwnsSocket )
{
   myNetworkStream = gcnew NetworkStream( mySocket,true );
}
else
{
   myNetworkStream = gcnew NetworkStream( mySocket );
}
// Examples for constructors that do not specify file permission.

// Create the NetworkStream for communicating with the remote host.
NetworkStream myNetworkStream;

if (networkStreamOwnsSocket){
     myNetworkStream = new NetworkStream(mySocket, true);
}
else{
     myNetworkStream = new NetworkStream(mySocket);
}
' Examples for constructors that do not specify file permission.
' Create the NetworkStream for communicating with the remote host.
Dim myNetworkStream As NetworkStream

If networkStreamOwnsSocket Then
   myNetworkStream = New NetworkStream(mySocket, True)
Else
   myNetworkStream = New NetworkStream(mySocket)
End If

Комментарии

NetworkStream создается с доступом на чтение и запись для указанного Socket.The NetworkStream is created with read/write access to the specified Socket. NetworkStream не владеет базовым Socket, поэтому вызов метода Close не закрывает Socket.The NetworkStream does not own the underlying Socket, so calling the Close method does not close the Socket.

Дополнительно

NetworkStream(Socket, Boolean)

Инициализирует новый экземпляр класса NetworkStream для указанного объекта Socket с заданным правом на владение Socket.Initializes a new instance of the NetworkStream class for the specified Socket with the specified Socket ownership.

public:
 NetworkStream(System::Net::Sockets::Socket ^ socket, bool ownsSocket);
public NetworkStream (System.Net.Sockets.Socket socket, bool ownsSocket);
new System.Net.Sockets.NetworkStream : System.Net.Sockets.Socket * bool -> System.Net.Sockets.NetworkStream
Public Sub New (socket As Socket, ownsSocket As Boolean)

Параметры

socket
Socket

Объект Socket, который будет использоваться NetworkStream для отправки и приема данных.The Socket that the NetworkStream will use to send and receive data.

ownsSocket
Boolean

Задайте значение true, чтобы указать на то, что объект NetworkStream будет иметь право владения объектом Socket; в противном случае — значение false.Set to true to indicate that the NetworkStream will take ownership of the Socket; otherwise, false.

Исключения

Параметр socket содержит значение null.The socket parameter is null.

Параметр socket не используется.The socket parameter is not connected.

-или--or- значение свойства SocketType параметра socket не является значением Stream.the value of the SocketType property of the socket parameter is not Stream.

-или--or- параметр socket находится в неблокирующем состоянии.the socket parameter is in a nonblocking state.

Примеры

В следующем примере кода создается NetworkStream с владельцем Socket.The following code example creates a NetworkStream with ownership of the Socket.

// Examples for constructors that do not specify file permission.
// Create the NetworkStream for communicating with the remote host.
NetworkStream^ myNetworkStream;

if ( networkStreamOwnsSocket )
{
   myNetworkStream = gcnew NetworkStream( mySocket,true );
}
else
{
   myNetworkStream = gcnew NetworkStream( mySocket );
}
// Examples for constructors that do not specify file permission.

// Create the NetworkStream for communicating with the remote host.
NetworkStream myNetworkStream;

if (networkStreamOwnsSocket){
     myNetworkStream = new NetworkStream(mySocket, true);
}
else{
     myNetworkStream = new NetworkStream(mySocket);
}
' Examples for constructors that do not specify file permission.
' Create the NetworkStream for communicating with the remote host.
Dim myNetworkStream As NetworkStream

If networkStreamOwnsSocket Then
   myNetworkStream = New NetworkStream(mySocket, True)
Else
   myNetworkStream = New NetworkStream(mySocket)
End If

Комментарии

NetworkStream создается с доступом на чтение и запись для указанного Socket.The NetworkStream is created with read/write access to the specified Socket. Если значение параметра ownsSocket равно true, NetworkStream становится владельцем базового Socketи вызов метода Close также закрывает базовый Socket.If the value of ownsSocket parameter is true, the NetworkStream takes ownership of the underlying Socket, and calling the Close method also closes the underlying Socket.

Дополнительно

NetworkStream(Socket, FileAccess)

Создает новый экземпляр класса NetworkStream для указанного объекта Socket с заданными правами на доступ.Creates a new instance of the NetworkStream class for the specified Socket with the specified access rights.

public:
 NetworkStream(System::Net::Sockets::Socket ^ socket, System::IO::FileAccess access);
public NetworkStream (System.Net.Sockets.Socket socket, System.IO.FileAccess access);
new System.Net.Sockets.NetworkStream : System.Net.Sockets.Socket * System.IO.FileAccess -> System.Net.Sockets.NetworkStream
Public Sub New (socket As Socket, access As FileAccess)

Параметры

socket
Socket

Объект Socket, который будет использоваться NetworkStream для отправки и приема данных.The Socket that the NetworkStream will use to send and receive data.

access
FileAccess

Комбинация битов значений FileAccess, указывающих тот тип доступа, который дан объекту NetworkStream с использованием предоставленного объекта Socket.A bitwise combination of the FileAccess values that specify the type of access given to the NetworkStream over the provided Socket.

Исключения

Параметр socket содержит значение null.The socket parameter is null.

Параметр socket не используется.The socket parameter is not connected.

-или--or- свойство SocketType параметра socket не содержит значения Stream.the SocketType property of the socket parameter is not Stream.

-или--or- параметр socket находится в неблокирующем состоянии.the socket parameter is in a nonblocking state.

Примеры

В следующем примере кода создается NetworkStream с возможностью чтения и записи в Socket.The following code example creates a NetworkStream with the ability to read and write to the Socket.

// Example for creating a NetworkStreams
mySocket->Connect( myIpEndPoint );

// Create the NetworkStream for communicating with the remote host.
NetworkStream^ myNetworkStream;
if ( networkStreamOwnsSocket )
{
   myNetworkStream = gcnew NetworkStream( mySocket,FileAccess::ReadWrite,true );
}
else
{
   myNetworkStream = gcnew NetworkStream( mySocket,FileAccess::ReadWrite );
}
// Example for creating a NetworkStreams

mySocket.Connect(myIpEndPoint);

// Create the NetworkStream for communicating with the remote host.
NetworkStream myNetworkStream;

if (networkStreamOwnsSocket){
     myNetworkStream = new NetworkStream(mySocket, FileAccess.ReadWrite, true);
}
else{
     myNetworkStream = new NetworkStream(mySocket, FileAccess.ReadWrite);
}

' Example for creating a NetworkStreams
mySocket.Connect(myIpEndPoint)

' Create the NetworkStream for communicating with the remote host.
Dim myNetworkStream As NetworkStream

If networkStreamOwnsSocket Then
   myNetworkStream = New NetworkStream(mySocket, FileAccess.ReadWrite, True)
Else
   myNetworkStream = New NetworkStream(mySocket, FileAccess.ReadWrite)
End If

Комментарии

NetworkStream создается с указанным доступом к заданному Socket.The NetworkStream is created with the specified access to the specified Socket. При использовании этого конструктора NetworkStream не владеет базовым Socket, поэтому вызов метода Close не закрывает базовый Socket.With this constructor, the NetworkStream does not own the underlying Socket, so calling the Close method does not close the underlying Socket.

Параметр access задает свойства CanRead и CanWrite NetworkStream.The access parameter sets the CanRead and CanWrite properties of the NetworkStream. Если указать Write, NetworkStream разрешает вызовы метода Write.If you specify Write, then the NetworkStream allows calls to the Write method. Если указать Read, NetworkStream разрешает вызовы метода Read.If you specify Read, then the NetworkStream allows calls to the Read method. Если указать ReadWrite, то оба вызова метода допускаются.If you specify ReadWrite, both method calls are allowed.

Дополнительно

NetworkStream(Socket, FileAccess, Boolean)

Создает новый экземпляр класса NetworkStream для указанного объекта Socket с заданными правами доступа и указанными правами владения объектом Socket.Creates a new instance of the NetworkStream class for the specified Socket with the specified access rights and the specified Socket ownership.

public:
 NetworkStream(System::Net::Sockets::Socket ^ socket, System::IO::FileAccess access, bool ownsSocket);
public NetworkStream (System.Net.Sockets.Socket socket, System.IO.FileAccess access, bool ownsSocket);
new System.Net.Sockets.NetworkStream : System.Net.Sockets.Socket * System.IO.FileAccess * bool -> System.Net.Sockets.NetworkStream
Public Sub New (socket As Socket, access As FileAccess, ownsSocket As Boolean)

Параметры

socket
Socket

Объект Socket, который будет использоваться NetworkStream для отправки и приема данных.The Socket that the NetworkStream will use to send and receive data.

access
FileAccess

Комбинация битов значений FileAccess, указывающая тот тип доступа, который дан объекту NetworkStream с использованием предоставленного объекта Socket.A bitwise combination of the FileAccess values that specifies the type of access given to the NetworkStream over the provided Socket.

ownsSocket
Boolean

Задайте значение true, чтобы указать на то, что объект NetworkStream будет иметь право владения объектом Socket; в противном случае — значение false.Set to true to indicate that the NetworkStream will take ownership of the Socket; otherwise, false.

Исключения

Параметр socket содержит значение null.The socket parameter is null.

Параметр socket не используется.The socket parameter is not connected.

-или--or- Свойство SocketType параметра socket не содержит значения Stream.The SocketType property of the socket parameter is not Stream.

-или--or- Параметр socket находится в неблокирующем состоянии.The socket parameter is in a nonblocking state.

Примеры

В следующем примере кода создается NetworkStream с возможностью чтения и записи в Socket.The following code example creates a NetworkStream with the ability to read and write to the Socket. Владельцем Socket присваивается этот NetworkStream путем указания true для параметра ownsSocket.Ownership of the Socket is given to this NetworkStream by specifying true for the ownsSocket parameter.

// Example for creating a NetworkStreams
mySocket->Connect( myIpEndPoint );

// Create the NetworkStream for communicating with the remote host.
NetworkStream^ myNetworkStream;
if ( networkStreamOwnsSocket )
{
   myNetworkStream = gcnew NetworkStream( mySocket,FileAccess::ReadWrite,true );
}
else
{
   myNetworkStream = gcnew NetworkStream( mySocket,FileAccess::ReadWrite );
}
// Example for creating a NetworkStreams

mySocket.Connect(myIpEndPoint);

// Create the NetworkStream for communicating with the remote host.
NetworkStream myNetworkStream;

if (networkStreamOwnsSocket){
     myNetworkStream = new NetworkStream(mySocket, FileAccess.ReadWrite, true);
}
else{
     myNetworkStream = new NetworkStream(mySocket, FileAccess.ReadWrite);
}

' Example for creating a NetworkStreams
mySocket.Connect(myIpEndPoint)

' Create the NetworkStream for communicating with the remote host.
Dim myNetworkStream As NetworkStream

If networkStreamOwnsSocket Then
   myNetworkStream = New NetworkStream(mySocket, FileAccess.ReadWrite, True)
Else
   myNetworkStream = New NetworkStream(mySocket, FileAccess.ReadWrite)
End If

Комментарии

NetworkStream создается с доступом на чтение и запись для указанного Socket.The NetworkStream is created with read/write access to the specified Socket. Если значение параметра ownsSocket равно true, NetworkStream становится владельцем базового Socketи вызов метода Close также закрывает базовый Socket.If the value of the ownsSocket parameter is true, the NetworkStream takes ownership of the underlying Socket, and calling the Close method also closes the underlying Socket.

Параметр access задает свойства CanRead и CanWrite NetworkStream.The access parameter sets the CanRead and CanWrite properties of the NetworkStream. Если указать Write, NetworkStream разрешает вызовы метода Write.If you specify Write, then the NetworkStream allows calls to the Write method. Если указать Read, NetworkStream разрешает вызовы метода Read.If you specify Read, then the NetworkStream allows calls to the Read method. Если указать ReadWrite, то оба вызова метода допускаются.If you specify ReadWrite, both method calls are allowed.

Дополнительно

Применяется к