FtpWebRequest.ConnectionGroupName Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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; }
public override string ConnectionGroupName { get; set; }
member this.ConnectionGroupName : string with get, set
Public Overrides Property ConnectionGroupName As String
Valor de propiedad
Un valor String que contiene un nombre de grupo de conexión.
Excepciones
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.