TransmitFileOptions Enumeración

Definición

Espacio de nombres:

System.Net.Sockets

Ensamblado:

System.dll

La enumeración TransmitFileOptions define los valores usados en las solicitudes de transferencia de archivos.

Esta enumeración admite una combinación bit a bit de sus valores de miembro.

public enum class TransmitFileOptions

[System.Flags]
public enum TransmitFileOptions

[<System.Flags>]
type TransmitFileOptions = 

Public Enum TransmitFileOptions

Herencia

Object

ValueType

Enum

TransmitFileOptions

Atributos

FlagsAttribute

Campos

Nombre	Valor	Description
UseDefaultWorkerThread	0	Use el subproceso predeterminado para procesar solicitudes de transferencia de archivos largas.
Disconnect	1	Inicie una desconexión de nivel de transporte después de que todos los datos del archivo se hayan puesto en cola para la transmisión. Cuando se usa con ReuseSocket, estas marcas devuelven el socket a un estado desconectado y reutilizable después de transmitir el archivo.
ReuseSocket	2	El identificador de socket se puede reutilizar cuando se completa la solicitud. Esta marca solo es válida si Disconnect también se especifica. Cuando se usa con Disconnect, estas marcas devuelven el socket a un estado desconectado y reutilizable después de transmitir el archivo.
WriteBehind	4	Complete la solicitud de transferencia de archivos inmediatamente, sin necesidad de estar pendiente. Si se especifica esta marca y la transferencia de archivos se realiza correctamente, el sistema ha aceptado los datos, pero no necesariamente confirmados por el extremo remoto. No use esta marca con las marcas Disconnect y ReuseSocket .
UseSystemThread	16	Use subprocesos del sistema para procesar solicitudes de transferencia de archivos largas.
UseKernelApc	32	Use llamadas a procedimientos asincrónicos de kernel (APCs) en lugar de subprocesos de trabajo para procesar solicitudes de transferencia de archivos largas. Las solicitudes largas se definen como solicitudes que requieren más de una sola lectura del archivo o una memoria caché; Por lo tanto, la solicitud depende del tamaño del archivo y de la longitud especificada del paquete de envío.

Ejemplos

En el ejemplo siguiente se muestra el uso de TransmitFileOptions en una llamada a Socket.SendFile. El archivo "test.txt" se encuentra en el directorio raíz del equipo local. En este ejemplo, se crea un prebuffer y un postbuffer de datos y se envían al host remoto con el archivo . Para usar el subproceso predeterminado del sistema, UseDefaultWorkerThread se especifica.

// Establish the local endpoint for the socket.
IPHostEntry ipHost = Dns.GetHostEntry(Dns.GetHostName());
IPAddress  ipAddr = ipHost.AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddr, 11000);

// Create a TCP socket.
Socket client = new Socket(AddressFamily.InterNetwork,
        SocketType.Stream, ProtocolType.Tcp);

// Connect the socket to the remote endpoint.
client.Connect(ipEndPoint);

// Send file fileName to the remote host with preBuffer and postBuffer data.
// There is a text file test.txt located in the root directory.
string fileName = "C:\\test.txt";

// Create the preBuffer data.
string string1 = String.Format("This is text data that precedes the file.{0}", Environment.NewLine);
byte[] preBuf = Encoding.ASCII.GetBytes(string1);

// Create the postBuffer data.
string string2 = String.Format("This is text data that will follow the file.{0}", Environment.NewLine);
byte[] postBuf = Encoding.ASCII.GetBytes(string2);

//Send file fileName with buffers and default flags to the remote device.
Console.WriteLine("Sending {0} with buffers to the host.{1}", fileName, Environment.NewLine);
client.SendFile(fileName, preBuf, postBuf, TransmitFileOptions.UseDefaultWorkerThread);

// Release the socket.
client.Shutdown(SocketShutdown.Both);
client.Close();

Comentarios

Note

Las marcas Disconnect y ReuseSocket devuelven el socket a un estado desconectado y reutilizable después de que se haya transmitido el archivo. Estas marcas no deben usarse en un socket en el que se haya solicitado calidad de servicio (QOS), ya que el proveedor de servicios podría eliminar inmediatamente cualquier calidad de servicio asociada al socket antes de que se haya completado la transferencia de archivos. El mejor enfoque para un socket habilitado para QOS es llamar Socket.Close cuando se ha completado la transferencia de archivos, en lugar de confiar en estas marcas.