FtpWebRequest.Method Propiedad

Definición

Obtiene o establece el comando que se envía al servidor FTP.

public:
 virtual property System::String ^ Method { System::String ^ get(); void set(System::String ^ value); };
public override string Method { get; set; }
member this.Method : string with get, set
Public Overrides Property Method As String

Valor de propiedad

Valor String que contiene el comando FTP que se envía al servidor. El valor predeterminado es DownloadFile.

Excepciones

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

El método no es válido.

o bien

El método no se admite.

o bien

Se especificaron varios métodos.

Ejemplos

En el ejemplo de código siguiente se establece esta propiedad en DeleteFile.

static bool DeleteFileOnServer( Uri^ serverUri )
{
   // The serverUri parameter should use the ftp:// scheme.
   // It contains the name of the server file that is to be deleted.
   // Example: ftp://contoso.com/someFile.txt.
   // 
   if ( serverUri->Scheme != Uri::UriSchemeFtp )
   {
      return false;
   }

   // Get the object used to communicate with the server.
   FtpWebRequest^ request = dynamic_cast<FtpWebRequest^>(WebRequest::Create( serverUri ));
   request->Method = WebRequestMethods::Ftp::DeleteFile;
   FtpWebResponse^ response = dynamic_cast<FtpWebResponse^>(request->GetResponse());
   Console::WriteLine( "Delete status: {0}", response->StatusDescription );
   response->Close();
   return true;
}
public static bool DeleteFileOnServer(Uri serverUri)
{
    // The serverUri parameter should use the ftp:// scheme.
    // It contains the name of the server file that is to be deleted.
    // Example: ftp://contoso.com/someFile.txt.
    //

    if (serverUri.Scheme != Uri.UriSchemeFtp)
    {
        return false;
    }
    // Get the object used to communicate with the server.
    FtpWebRequest request = (FtpWebRequest)WebRequest.Create(serverUri);
    request.Method = WebRequestMethods.Ftp.DeleteFile;

    FtpWebResponse response = (FtpWebResponse) request.GetResponse();
    Console.WriteLine("Delete status: {0}",response.StatusDescription);
    response.Close();
    return true;
}

Comentarios

La Method propiedad determina qué comando se envía al servidor. Se establece Method mediante las cadenas definidas en los miembros del campo público de la WebRequestMethods.Ftp clase . Tenga en cuenta que las cadenas definidas en la WebRequestMethods.Ftp clase son las únicas opciones admitidas para la Method propiedad . Si se establece la Method propiedad en cualquier otro valor, se producirá una ArgumentException excepción.

Al establecer MethodUploadFileen , debe hacerlo antes de llamar al GetRequestStream método . Si no se llama a estos miembros en el orden correcto, se produce una ProtocolViolationException excepción al intentar obtener la secuencia de solicitudes.

Las credenciales proporcionadas para el FtpWebRequest objeto deben tener permiso para realizar el método especificado. Si no es así, se produce un error en el comando FTP.

Para determinar el éxito o el error de un comando, compruebe las StatusCode propiedades y StatusDescription .

Se aplica a

Consulte también