FtpWebRequest.ConnectionGroupName Propiedad

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.Requests.dll

Source:

FtpWebRequest.cs

Obtiene o establece el nombre del grupo de conexiones que contiene el punto de servicio usado para enviar la solicitud actual.

public:
 virtual property System::String ^ ConnectionGroupName { System::String ^ get(); void set(System::String ^ value); };

public override string? ConnectionGroupName { get; set; }

member this.ConnectionGroupName : string with get, set

Public Overrides Property ConnectionGroupName As String

Valor de propiedad

String

Un valor String que contiene un nombre de grupo de conexión.

Excepciones

InvalidOperationException

Se ha especificado un nuevo valor en esta propiedad para una solicitud que ya está en curso.

Ejemplos

En el ejemplo de código siguiente se recupera el valor de esta propiedad.

IWebProxy^ proxy = request->Proxy;
if ( proxy )
{
   Console::WriteLine( "Proxy: {0}", proxy->GetProxy( request->RequestUri ) );
}
else
{
   Console::WriteLine( "Proxy: (none)" );
}

Console::WriteLine( "ConnectionGroup: {0}", request->ConnectionGroupName == nullptr ? "none" : request->ConnectionGroupName );

IWebProxy proxy = request.Proxy;
if (proxy != null)
{
    Console.WriteLine("Proxy: {0}", proxy.GetProxy(request.RequestUri));
}
else
{
    Console.WriteLine("Proxy: (none)");
}

Console.WriteLine("ConnectionGroup: {0}",
    request.ConnectionGroupName == null ? "none" : request.ConnectionGroupName
);

Comentarios

Los grupos de conexiones asocian un conjunto de solicitudes con una conexión determinada o un conjunto de conexiones. Las conexiones de un grupo de conexiones solo se pueden reutilizar mediante solicitudes que se originan en el mismo dominio de aplicación, cuando las credenciales de la solicitud son las mismas y la solicitud especifica el nombre del grupo de conexiones. Cuando una solicitud no especifica un nombre de grupo de conexiones, se puede usar cualquier conexión existente al servidor solicitado que no esté asociado a un grupo de conexiones. Cuando las credenciales no son las mismas, se cierra la conexión existente y se debe volver a autenticar la nueva solicitud.

El uso de grupos de conexiones puede mejorar el rendimiento porque esto permite que todas las solicitudes de un usuario reutilicen la conexión autenticada con las credenciales del usuario.

El cambio de la ConnectionGroupName propiedad después de llamar al GetRequestStreammétodo , BeginGetRequestStream, GetResponseo BeginGetResponse provoca una InvalidOperationException excepción.

Consulte también

• FtpWebResponse
• FtpStatusCode
• WebRequestMethods.Ftp
• WebRequest
• WebResponse
• WebClient
• Administrar conexiones