이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

FileWebRequest 클래스

 

게시 날짜: 2016년 11월

파일 시스템 구현을 제공는 WebRequest 클래스입니다.

네임스페이스:   System.Net
어셈블리:  System(System.dll에 있음)

System.Object
  System.MarshalByRefObject
    System.Net.WebRequest
      System.Net.FileWebRequest

[SerializableAttribute]
public class FileWebRequest : WebRequest, ISerializable

이름설명
System_CAPS_protmethodFileWebRequest(SerializationInfo, StreamingContext)

사용되지 않습니다. FileWebRequestSerializationInfo 클래스의 지정된 인스턴스로부터 StreamingContext 클래스의 새 인스턴스를 초기화합니다.

이름설명
System_CAPS_pubpropertyAuthenticationLevel

이 요청에 사용되는 인증 및 가장 수준을 나타내는 값을 가져오거나 설정합니다.(WebRequest에서 상속됨)

System_CAPS_pubpropertyCachePolicy

이 요청에 대한 캐시 정책을 가져오거나 설정합니다.(WebRequest에서 상속됨)

System_CAPS_pubpropertyConnectionGroupName

요청에 대한 연결 그룹의 이름을 가져오거나 설정합니다. 이 속성은 나중에 사용할 수는 예약 되어 있습니다.(WebRequest.ConnectionGroupName을(를) 재정의함)

System_CAPS_pubpropertyContentLength

전송 되는 데이터의 콘텐츠 길이 가져오거나 설정 합니다.(WebRequest.ContentLength을(를) 재정의함)

System_CAPS_pubpropertyContentType

전송 되는 데이터의 콘텐츠 형식을 가져오거나 설정 합니다. 이 속성은 나중에 사용할 수는 예약 되어 있습니다.(WebRequest.ContentType을(를) 재정의함)

System_CAPS_pubpropertyCreatorInstance

사용되지 않습니다. 하위 클래스에서 재정의될 때, 지정된 URI 에 요청하기 위해 인스턴스화된 WebRequest를 만드는 데 사용되는 IWebRequestCreate 클래스에서 파생된 팩터리 개체를 가져옵니다.(WebRequest에서 상속됨)

System_CAPS_pubpropertyCredentials

이 요청과 관련 된 자격 증명을 가져오거나 설정 합니다. 이 속성은 나중에 사용할 수는 예약 되어 있습니다.(WebRequest.Credentials을(를) 재정의함)

System_CAPS_pubpropertyHeaders

요청과 연결 된 이름/값 쌍의 컬렉션을 가져옵니다. 이 속성은 나중에 사용할 수는 예약 되어 있습니다.(WebRequest.Headers을(를) 재정의함)

System_CAPS_pubpropertyImpersonationLevel

현재 요청에 대한 가장 수준을 가져오거나 설정합니다.(WebRequest에서 상속됨)

System_CAPS_pubpropertyMethod

요청에 사용 되는 프로토콜 메서드를 가져오거나 설정 합니다. 이 속성은 나중에 사용할 수는 예약 되어 있습니다.(WebRequest.Method을(를) 재정의함)

System_CAPS_pubpropertyPreAuthenticate

요청을 미리 인증 여부를 나타내는 값을 가져오거나 설정 합니다. 이 속성은 나중에 사용할 수는 예약 되어 있습니다.(WebRequest.PreAuthenticate을(를) 재정의함)

System_CAPS_pubpropertyProxy

이 요청에 사용할 네트워크 프록시를 가져오거나 설정 합니다. 이 속성은 나중에 사용할 수는 예약 되어 있습니다.(WebRequest.Proxy을(를) 재정의함)

System_CAPS_pubpropertyRequestUri

식별자 URI (Uniform Resource) 요청을 가져옵니다.(WebRequest.RequestUri을(를) 재정의함)

System_CAPS_pubpropertyTimeout

요청 시간이 초과 될 때까지 시간을 가져오거나 설정 합니다.(WebRequest.Timeout을(를) 재정의함)

System_CAPS_pubpropertyUseDefaultCredentials

이 API는 제품 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. 항상 NotSupportedException을 throw합니다.(WebRequest.UseDefaultCredentials을(를) 재정의함)

이름설명
System_CAPS_pubmethodAbort()

인터넷 리소스에 대한 요청을 취소합니다.(WebRequest.Abort()을(를) 재정의함)

System_CAPS_pubmethodBeginGetRequestStream(AsyncCallback, Object)

데이터를 쓰는 데 사용할 Stream 개체에 대한 비동기 요청을 시작합니다.(WebRequest.BeginGetRequestStream(AsyncCallback, Object)을(를) 재정의함)

System_CAPS_pubmethodBeginGetResponse(AsyncCallback, Object)

파일 시스템 리소스에 대 한 비동기 요청을 시작 합니다.(WebRequest.BeginGetResponse(AsyncCallback, Object)을(를) 재정의함)

System_CAPS_pubmethodCreateObjRef(Type)

원격 개체와 통신 하는 데 프록시를 생성 하는 데 필요한 모든 관련 정보를 포함 하는 개체를 만듭니다.(MarshalByRefObject에서 상속됨)

System_CAPS_pubmethodEndGetRequestStream(IAsyncResult)

에 대 한 비동기 요청을 종료 한 Stream 응용 프로그램 데이터를 쓰는 데 사용 하는 인스턴스.(WebRequest.EndGetRequestStream(IAsyncResult)을(를) 재정의함)

System_CAPS_pubmethodEndGetResponse(IAsyncResult)

파일 시스템 리소스에 대 한 비동기 요청을 종료 합니다.(WebRequest.EndGetResponse(IAsyncResult)을(를) 재정의함)

System_CAPS_pubmethodEquals(Object)

지정한 개체가 현재 개체와 같은지 여부를 확인합니다. (Object에서 상속됨)

System_CAPS_protmethodFinalize()

개체가 가비지 수집자에서 회수되기 전에, 해당 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)

System_CAPS_pubmethodGetHashCode()

기본 해시 함수로 작동합니다.(Object에서 상속됨)

System_CAPS_pubmethodGetLifetimeService()

이 인스턴스에 대 한 수명 정책을 제어 하는 수명이 현재 서비스 개체를 검색 합니다.(MarshalByRefObject에서 상속됨)

System_CAPS_protmethodGetObjectData(SerializationInfo, StreamingContext)

대상 개체를 직렬화하는 데 필요한 데이터로 SerializationInfo를 채웁니다.(WebRequest.GetObjectData(SerializationInfo, StreamingContext)을(를) 재정의함)

System_CAPS_pubmethodGetRequestStream()

반환 된 Stream 파일 시스템 리소스에 데이터를 쓰기 위한 개체입니다.(WebRequest.GetRequestStream()을(를) 재정의함)

System_CAPS_pubmethodGetRequestStreamAsync()

서브클래스에서 재정의될 때, 인터넷 리소스에 비동기 작업으로 데이터를 쓰기 위해 Stream을 반환합니다.(WebRequest에서 상속됨)

System_CAPS_pubmethodGetResponse()

파일 시스템 요청에 대 한 응답을 반환합니다.(WebRequest.GetResponse()을(를) 재정의함)

System_CAPS_pubmethodGetResponseAsync()

하위 항목 클래스에 재정의될 때, 인터넷 요청에 대한 응답을 비동기 작업으로 반환합니다.(WebRequest에서 상속됨)

System_CAPS_pubmethodGetType()

현재 인스턴스의 Type을 가져옵니다.(Object에서 상속됨)

System_CAPS_pubmethodInitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.(MarshalByRefObject에서 상속됨)

System_CAPS_protmethodMemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.(Object에서 상속됨)

System_CAPS_protmethodMemberwiseClone(Boolean)

현재의 단순 복사본을 만듭니다 MarshalByRefObject 개체입니다.(MarshalByRefObject에서 상속됨)

System_CAPS_pubmethodToString()

현재 개체를 나타내는 문자열을 반환합니다.(Object에서 상속됨)

이름설명
System_CAPS_pubinterfaceSystem_CAPS_privmethodISerializable.GetObjectData(SerializationInfo, StreamingContext)

이 API는 제품 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. 정보를 표시 한 SerializationInfo 개체를 serialize 하는 데 필요한 데이터로 FileWebRequest합니다.

FileWebRequest 클래스가 구현 하는 WebRequestabstract 기본 클래스를 사용 하는 Uniform Resource Identifier (Uri)는 file:// 체계를 로컬 파일을 요청 합니다.

사용 하지 않는 FileWebRequest 생성자입니다. 사용 된 WebRequest.Create 의 새 인스턴스를 초기화 하는 메서드는 FileWebRequest 클래스입니다. URI 체계는 경우 file://, Create 메서드가 반환 되는 FileWebRequest 개체입니다.

GetResponse 에 지정 된 파일에 대 한 동기 요청을 수행 하는 메서드는 RequestUri 속성과 반환은 FileWebResponse 응답을 포함 하는 개체입니다. 사용 하 여 파일에 대 한 비동기 요청을 만들 수는 BeginGetResponseEndGetResponse 메서드.

파일에 데이터를 기록 하려는 경우는 GetRequestStream 메서드가 반환 되는 Stream 인스턴스에 쓸 수 있습니다. BeginGetRequestStreamEndGetRequestStream 메서드는 비동기 쓰기 데이터 스트림에 대 한 액세스를 제공 합니다.

FileWebRequest 기반으로 하는 클래스는 File 오류 처리 및 코드 액세스 보안에 대 한 클래스입니다.

다음 코드 예제에서는 FileWebRequest 파일 시스템 리소스에 액세스 하는 클래스입니다.

// 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 ();
            }
        }
    }
}

.NET Framework
1.1 이후 사용 가능

이 형식의 모든 public static(Visual Basic의 공유 Visual Basic의 경우) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전이 보장되지 않습니다.

맨 위로 이동
표시: