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 con el 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 permite que todas las solicitudes de un usuario vuelvan a usar la conexión autenticada con las credenciales del usuario.

Al cambiar la ConnectionGroupName propiedad después de llamar al GetRequestStreammétodo , BeginGetRequestStreamGetResponse, o BeginGetResponse , se produce una InvalidOperationException excepción.

Consulte también

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