FileWebRequest Clase

Referencia

Definición

Espacio de nombres:: System.Net

Ensamblado:: System.Net.Requests.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

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í.

Proporciona una implementación del sistema de archivos de la clase WebRequest.

public ref class FileWebRequest : System::Net::WebRequest, System::Runtime::Serialization::ISerializable

public ref class FileWebRequest : System::Net::WebRequest

public class FileWebRequest : System.Net.WebRequest, System.Runtime.Serialization.ISerializable

[System.Serializable]
public class FileWebRequest : System.Net.WebRequest, System.Runtime.Serialization.ISerializable

public class FileWebRequest : System.Net.WebRequest

type FileWebRequest = class
    inherit WebRequest
    interface ISerializable

[<System.Serializable>]
type FileWebRequest = class
    inherit WebRequest
    interface ISerializable

Public Class FileWebRequest
Inherits WebRequest
Implements ISerializable

Public Class FileWebRequest
Inherits WebRequest

Herencia: Object

MarshalByRefObject

WebRequest
FileWebRequest

Atributos: SerializableAttribute

Implementaciones: ISerializable

Ejemplos

En el ejemplo de código siguiente se usa la FileWebRequest clase para acceder a un recurso del sistema de archivos.

// This program creates or open a text file in which it stores a string.
// Both file and string are passed by the user.
// Note. In order for this program to work, the folder containing the test file
// must be shared with its permissions set to allow write access.
#using <System.dll>

using namespace System;
using namespace System::IO;
using namespace System::Text;
using namespace System::Net;
ref class TestGetRequestStream
{
private:
   static FileWebRequest^ myFileWebRequest;
   static void showUsage()
   {
      Console::WriteLine( "\nPlease enter file name and timeout :" );
      Console::WriteLine( "Usage: cs_getrequeststream <systemname>/<sharedfoldername>/<filename> timeout" );
      Console::WriteLine( "Example: cs_getrequeststream ndpue/temp/hello.txt 1000" );
      Console::WriteLine( "Small timeout values (for instance 3 or less) cause a timeout exception." );
   }

   static void makeFileRequest( String^ fileName, int timeout )
   {
      try
      {
         
         // Create a Uri object.
         Uri^ myUrl = gcnew Uri( String::Format( "file://{0}", fileName ) );
         
         // Create a FileWebRequest object.
         myFileWebRequest = dynamic_cast<FileWebRequest^>(WebRequest::CreateDefault( myUrl ));
         
         // Set the timeout to the value selected by the user.
         myFileWebRequest->Timeout = timeout;
         
         // Set the Method property to POST
         myFileWebRequest->Method = "POST";
         
      }
      catch ( WebException^ e ) 
      {
         Console::WriteLine( "WebException: {0}", e->Message );
      }
      catch ( UriFormatException^ e ) 
      {
         Console::WriteLine( "UriFormatWebException: {0}", e->Message );
      }

   }

   static void writeToFile()
   {
      try
      {
         
         // Enter the string to write into the file.
         Console::WriteLine( "Enter the string you want to write:" );
         String^ userInput = Console::ReadLine();
         
         // Convert the string to Byte array.
         ASCIIEncoding^ encoder = gcnew ASCIIEncoding;
         array<Byte>^byteArray = encoder->GetBytes( userInput );
         
         // Set the ContentLength property.
         myFileWebRequest->ContentLength = byteArray->Length;
         String^ contentLength = myFileWebRequest->ContentLength.ToString();
         Console::WriteLine( "\nThe content length is {0}.", contentLength );
         
         // Get the file stream handler to write into the file.
         Stream^ readStream = myFileWebRequest->GetRequestStream();
         
         // Write to the file stream.
         // Note. In order for this to work the file must be accessible
         // on the network. This can be accomplished by setting the property
         // sharing of the folder containg the file. The permissions
         // can be set so everyone can modify the file.
         // FileWebRequest::Credentials property cannot be used for this purpose.
         readStream->Write( byteArray, 0, userInput->Length );
         Console::WriteLine( "\nThe String you entered was successfully written into the file." );
         
         readStream->Close();
      }
      catch ( WebException^ e ) 
      {
         Console::WriteLine( "The WebException: {0}", e->Message );
      }
      catch ( UriFormatException^ e ) 
      {
         Console::WriteLine( "The UriFormatWebException: {0}", e->Message );
      }

   }


public:
   static void Main()
   {
      array<String^>^args = Environment::GetCommandLineArgs();
      if ( args->Length < 3 )
            showUsage();
      else
      {
         makeFileRequest( args[ 1 ], Int32::Parse( args[ 2 ] ) );
         writeToFile();
      }
   }

};

int main()
{
   TestGetRequestStream::Main();
}

// This example creates or opens a text file and stores a string in it.
// Both the file and the string are passed by the user.
// Note. For this program to work, the folder containing the test file
// must be shared, with its permissions set to allow write access.
using System.Net;
using System;
using System.IO;
using System.Text;

namespace Mssc.PluggableProtocols.File
{
    class TestGetRequestStream
    {
        private static FileWebRequest myFileWebRequest;

        private static void showUsage ()
        {
            Console.WriteLine ("\nPlease enter file name and timeout :");
            Console.WriteLine ("Usage: cs_getrequeststream <systemname>/<sharedfoldername>/<filename> timeout");
            Console.WriteLine ("Example: cs_getrequeststream ngetrequestrtream() ndpue/temp/hello.txt  1000");
            Console.WriteLine ("Small time-out values (for example, 3 or less) cause a time-out exception.");
        }

        private static void makeFileRequest (string fileName, int timeout)
        {
            try
            {
                // Create a Uri object.
                Uri myUrl = new Uri ("file://" + fileName);

                // Create a FileWebRequest object.
                myFileWebRequest = (FileWebRequest)WebRequest.CreateDefault (myUrl);

                // Set the time-out to the value selected by the user.
                myFileWebRequest.Timeout = timeout;

                // Set the Method property to POST
                myFileWebRequest.Method = "POST";
            }
            catch (WebException e)
            {
                Console.WriteLine ("WebException: " + e.Message);
            }
            catch (UriFormatException e)
            {
                Console.WriteLine ("UriFormatWebException: " + e.Message);
            }
        }

        private static void writeToFile ()
        {
            try
            {
                // Enter the string to write to the file.
                Console.WriteLine ("Enter the string you want to write:");

                string userInput = Console.ReadLine ();

                // Convert the string to a byte array.
                ASCIIEncoding encoder = new ASCIIEncoding ();
                byte[] byteArray = encoder.GetBytes (userInput);

                // Set the ContentLength property.
                myFileWebRequest.ContentLength = byteArray.Length;

                string contentLength = myFileWebRequest.ContentLength.ToString ();

                Console.WriteLine ("\nThe content length is {0}.", contentLength);

                // Get the file stream handler to write to the file.
                Stream readStream = myFileWebRequest.GetRequestStream ();

                // Write to the file stream.
                // Note.  For this to work, the file must be accessible
                // on the network. This can be accomplished by setting the property
                // sharing of the folder containg the file.
                // FileWebRequest.Credentials property cannot be used for this purpose.
                readStream.Write (byteArray, 0, userInput.Length);
                Console.WriteLine ("\nThe String you entered was successfully written to the file.");

                readStream.Close ();
            }
            catch (WebException e)
            {
                Console.WriteLine ("The WebException: " + e.Message);
            }
            catch (UriFormatException e)
            {
                Console.WriteLine ("The UriFormatWebException: " + e.Message);
            }
        }

        public static void Main (String[] args)
        {
            if (args.Length < 2)
            {
                showUsage ();
            }
            else
            {
                makeFileRequest (args[0], int.Parse (args[1]));
                writeToFile ();
            }
        }
    }
}

'
' This example creates or opens a text file and stores a string in it. 
' Both the file and the string are passed by the user.
' Note. For this program to work, the folder containing the test file
' must be shared, with its permissions set to allow write access. 

Imports System.Net
Imports System.IO
Imports System.Text

Namespace Mssc.PluggableProtocols.File

    Module TestGetRequestStream

        Class TestGetRequestStream

            Private Shared myFileWebRequest As FileWebRequest

            ' Show how to use this program.
            Private Shared Sub showUsage()
                Console.WriteLine(ControlChars.Lf + "Please enter file name and timeout :")
                Console.WriteLine("Usage: vb_getrequeststream <systemname>/<sharedfoldername>/<filename> timeout")
                Console.WriteLine("Example: vb_getrequeststream ngetrequestrtream() ndpue/temp/hello.txt  1000")
                Console.WriteLine("Small time-out values (for example, 3 or less) cause a time-out exception.")
            End Sub

            Private Shared Sub makeFileRequest(ByVal fileName As String, ByVal timeout As Integer)
                Try
                    ' Create a Uri object.to access the file requested by the user. 
                    Dim myUrl As New Uri("file://" + fileName)

                    ' Create a FileWebRequest object.for the requeste file.
                    myFileWebRequest = CType(WebRequest.CreateDefault(myUrl), FileWebRequest)

                    ' Set the time-out to the value selected by the user.
                    myFileWebRequest.Timeout = timeout

                    ' Set the Method property to POST  
                    myFileWebRequest.Method = "POST"


                Catch e As WebException
                    Console.WriteLine(("WebException is: " + e.Message))
                Catch e As UriFormatException
                    Console.WriteLine(("UriFormatWebException is: " + e.Message))
                End Try

            End Sub

            Private Shared Sub writeToFile()
                Try
                    ' Enter the string to write to the file.
                    Console.WriteLine("Enter the string you want to write:")
                    Dim userInput As String = Console.ReadLine()

                    ' Convert the string to a byte array.
                    Dim encoder As New ASCIIEncoding
                    Dim byteArray As Byte() = encoder.GetBytes(userInput)

                    ' Set the ContentLength property.
                    myFileWebRequest.ContentLength = byteArray.Length

                    Dim contentLength As String = myFileWebRequest.ContentLength.ToString()

                    Console.WriteLine(ControlChars.Lf + "The content length is {0}.", contentLength)


                    ' Get the file stream handler to write to the file.
                    Dim readStream As Stream = myFileWebRequest.GetRequestStream()

                    ' Write to the stream. 
                    ' Note. For this to work the file must be accessible
                    ' on the network. This can be accomplished by setting the property
                    ' sharing of the folder containg the file.  
                    ' FileWebRequest.Credentials property cannot be used for this purpose.
                    readStream.Write(byteArray, 0, userInput.Length)


                    Console.WriteLine(ControlChars.Lf + "The String you entered was successfully written to the file.")

                    readStream.Close()

                Catch e As WebException
                    Console.WriteLine(("WebException is: " + e.Message))
                Catch e As UriFormatException
                    Console.WriteLine(("UriFormatWebException is: " + e.Message))
                End Try

            End Sub

            Public Shared Sub Main(ByVal args() As String)

                If args.Length < 2 Then
                    showUsage()
                Else
                    makeFileRequest(args(0), Integer.Parse(args(1)))
                    writeToFile()
                End If

            End Sub

        End Class



    End Module

End Namespace

Comentarios

La FileWebRequest clase implementa la WebRequest abstract clase base para identificadores uniformes de recursos (URI) que usan el file:// esquema para solicitar archivos locales.

No use el FileWebRequest constructor . Use el WebRequest.Create método para inicializar nuevas instancias de la FileWebRequest clase . Si el esquema de URI es file://, el Create método devuelve un FileWebRequest objeto .

El GetResponse método realiza una solicitud sincrónica para el archivo especificado en la RequestUri propiedad y devuelve un FileWebResponse objeto que contiene la respuesta. Puede realizar una solicitud asincrónica para el archivo mediante los BeginGetResponse métodos y EndGetResponse .

Cuando desea escribir datos en un archivo, el GetRequestStream método devuelve una Stream instancia en la que se va a escribir. Los BeginGetRequestStream métodos y EndGetRequestStream proporcionan acceso asincrónico al flujo de datos de escritura.

La FileWebRequest clase se basa en la clase para el File control de errores y la seguridad de acceso al código.

Constructores

FileWebRequest(SerializationInfo, StreamingContext)

Obsoleto.

Inicializa una nueva instancia de la clase FileWebRequest desde las instancias especificadas de las clases SerializationInfo y StreamingContext.

Propiedades

AuthenticationLevel	Obtiene o establece valores que indican el nivel de autenticación y de suplantación utilizados para esta solicitud. (Heredado de WebRequest)
CachePolicy	Obtiene o establece la directiva de caché para esta solicitud. (Heredado de WebRequest)
ConnectionGroupName	Obtiene o establece el nombre del grupo de conexiones para la solicitud. Esta propiedad está reservada para un uso futuro.
ContentLength	Obtiene o establece la longitud del contenido de los datos que se envían.
ContentType	Obtiene o establece el tipo de contenido de los datos que se envían. Esta propiedad está reservada para un uso futuro.
CreatorInstance	Obsoleto. Cuando se reemplaza en una clase descendiente, obtiene el objeto generador derivado de la clase IWebRequestCreate usada para crear la instancia de WebRequest para efectuar la solicitud al URI especificado. (Heredado de WebRequest)
Credentials	Obtiene o establece las credenciales asociadas a esta solicitud. Esta propiedad está reservada para un uso futuro.
Headers	Obtiene una colección de los pares de nombre y valor asociados a la solicitud. Esta propiedad está reservada para un uso futuro.
ImpersonationLevel	Obtiene o establece el nivel de suplantación para la solicitud actual. (Heredado de WebRequest)
Method	Obtiene o establece el método de protocolo utilizado para realizar la solicitud. Esta propiedad está reservada para un uso futuro.
PreAuthenticate	Obtiene o establece un valor que indica si se va a realizar la autenticación previa de una solicitud. Esta propiedad está reservada para un uso futuro.
Proxy	Obtiene o establece el proxy de red que se va a utilizar para esta solicitud. Esta propiedad está reservada para un uso futuro.
RequestUri	Obtiene el identificador uniforme de recursos (URI) de la solicitud.
Timeout	Obtiene o establece el tiempo que transcurre hasta que se agota el tiempo de espera de la solicitud.
UseDefaultCredentials	Siempre inicia una NotSupportedException.
UseDefaultCredentials	Cuando se reemplaza en una clase descendiente, obtiene o establece un valor Boolean que controla si se envían DefaultCredentials con las solicitudes. (Heredado de WebRequest)

Métodos

Abort()	Cancela una solicitud de un recurso de Internet.
Abort()	Anula la solicitud. (Heredado de WebRequest)
BeginGetRequestStream(AsyncCallback, Object)	Inicia una solicitud asincrónica de un objeto Stream que se va a utilizar para escribir datos.
BeginGetResponse(AsyncCallback, Object)	Inicia una solicitud asincrónica de un recurso del sistema de archivos.
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
EndGetRequestStream(IAsyncResult)	Finaliza una solicitud asincrónica de una instancia de Stream que la aplicación usa para escribir datos.
EndGetResponse(IAsyncResult)	Termina una solicitud asincrónica de un recurso del sistema de archivos.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoleto. Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Obsoleto. Llena SerializationInfo con los datos necesarios para serializar el objeto de destino.
GetObjectData(SerializationInfo, StreamingContext)	Obsoleto. Llena SerializationInfo con los datos necesarios para serializar el objeto de destino. (Heredado de WebRequest)
GetRequestStream()	Devuelve un objeto Stream para escribir datos en el recurso del sistema de archivos.
GetRequestStreamAsync()	Devuelve una secuencia para escribir datos en el recurso del sistema de archivos como una operación asincrónica.
GetRequestStreamAsync()	Cuando se invalida en una clase descendiente, devuelve un objeto Stream para escribir datos en el recurso de Internet como una operación asincrónica. (Heredado de WebRequest)
GetResponse()	Devuelve una respuesta a una solicitud del sistema de archivos.
GetResponseAsync()	Devuelve una respuesta a una solicitud del sistema de archivos como una operación asincrónica.
GetResponseAsync()	Cuando se invalida en una clase descendiente, devuelve una respuesta a una solicitud de Internet como una operación asincrónica. (Heredado de WebRequest)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obsoleto. Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

ISerializable.GetObjectData(SerializationInfo, StreamingContext)