HttpListenerPrefixCollection.Add(String) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
컬렉션에 URI(Uniform Resource Identifier) 접두사를 추가합니다.
public:
virtual void Add(System::String ^ uriPrefix);public void Add (string uriPrefix);abstract member Add : string -> unit
override this.Add : string -> unitPublic Sub Add (uriPrefix As String)매개 변수
구현
예외
uriPrefix이(가) null인 경우
uriPrefix가 http:// 또는 https:// 체계를 사용하지 않는 경우 이것이 HttpListener 개체에 대해 유일하게 지원되는 스키마입니다.
또는
uriPrefix가 올바른 형식의 URI 접두사가 아닌 경우. 이 문자열이 "/"로 종료되는지 확인합니다.
이 컬렉션과 연결된 HttpListener는 닫힙니다.
Windows 함수 호출이 실패한 경우. 예외의 ErrorCode 속성을 검토하여 예외의 원인을 확인할 수 있습니다. 다른 HttpListener에서 uriPrefix 접두사를 이미 추가한 경우 이 예외가 throw됩니다.
예제
다음 코드 예제에서는 를 만들고 HttpListener 사용자 지정 접두사를 에 HttpListenerPrefixCollection추가합니다.
// This example requires the System and System.Net namespaces.
public static void SimpleListenerExample(string[] prefixes)
{
if (!HttpListener.IsSupported)
{
Console.WriteLine ("Windows XP SP2 or Server 2003 is required to use the HttpListener class.");
return;
}
// URI prefixes are required,
// for example "http://contoso.com:8080/index/".
if (prefixes == null || prefixes.Length == 0)
throw new ArgumentException("prefixes");
// Create a listener.
HttpListener listener = new HttpListener();
// Add the prefixes.
foreach (string s in prefixes)
{
listener.Prefixes.Add(s);
}
listener.Start();
Console.WriteLine("Listening...");
// Note: The GetContext method blocks while waiting for a request.
HttpListenerContext context = listener.GetContext();
HttpListenerRequest request = context.Request;
// Obtain a response object.
HttpListenerResponse response = context.Response;
// Construct a response.
string responseString = "<HTML><BODY> Hello world!</BODY></HTML>";
byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
// Get a response stream and write the response to it.
response.ContentLength64 = buffer.Length;
System.IO.Stream output = response.OutputStream;
output.Write(buffer,0,buffer.Length);
// You must close the output stream.
output.Close();
listener.Stop();
}
Public Shared Sub SimpleListenerExample(prefixes As String())
If Not HttpListener.IsSupported Then
Console.WriteLine("Windows XP SP2 or Server 2003 is required to use the HttpListener class.")
Return
End If
' URI prefixes are required,
' for example "http://contoso.com:8080/index/".
If prefixes Is Nothing Or prefixes.Length = 0 Then
Throw New ArgumentException("prefixes")
End If
' Create a listener
Dim listener = New HttpListener()
For Each s As String In prefixes
listener.Prefixes.Add(s)
Next
listener.Start()
Console.WriteLine("Listening...")
' Note: The GetContext method blocks while waiting for a request.
Dim context As HttpListenerContext = listener.GetContext()
Console.WriteLine("Listening...")
' Obtain a response object
Dim request As HttpListenerRequest = context.Request
' Construct a response.
Dim response As HttpListenerResponse = context.Response
Dim responseString As String = "<HTML><BODY> Hello world!</BODY></HTML>"
Dim buffer As Byte() = System.Text.Encoding.UTF8.GetBytes(responseString)
' Get a response stream and write the response to it.
response.ContentLength64 = buffer.Length
Dim output As System.IO.Stream = response.OutputStream
output.Write(buffer, 0, buffer.Length)
'You must close the output stream.
output.Close()
listener.Stop()
End Sub
설명
이 메서드는 연결된 HttpListener 개체에서 관리하는 접두사 집합에 URI 접두사를 추가합니다. 유효한지 확인할 uriPrefix 때 대/소문자를 무시합니다.
URI 접두사 문자열은 스키마(http 또는 https), 호스트, 선택적 포트 및 선택적 경로(예: "http://www.contoso.com:8080/customerData/")로 구성됩니다. 이 접두사는 슬래시("/")로 종결되어야 합니다.
HttpListener 요청된 URI와 가장 일치하는 접두사를 가진 은 요청에 응답합니다. 여러 HttpListener 개체가 동일한 접두사를 추가할 수 없습니다.
HttpListenerException 이미 사용 중인 접두사를 추가하는 경우 HttpListener 예외가 throw됩니다.
포트를 지정하면 호스트 요소를 "*"로 바꿔 요청된 URI가 HttpListener 다른 접두사와 일치하지 않는 경우 에서 포트로 전송된 요청을 수락함을 나타낼 수 있습니다. 예를 들어 요청된 URI가 다른 HttpListener에서 처리되지 않을 때 포트 8080으로 전송된 모든 요청을 수신하려면 접두사는 "http://*:8080/"입니다. 마찬가지로 에서 포트로 전송된 HttpListener 모든 요청을 수락하도록 지정하려면 호스트 요소를 "" 문자 "+https://+:8080/"로 바꿉니다. "*" 및 "+" 문자는 경로를 포함하는 접두사에 있을 수 있습니다.
.NET 4.5.3 및 Windows 10부터 와일드카드 하위 도메인은 개체에서 관리 HttpListener 되는 URI 접두사에서 지원됩니다. 와일드카드 하위 도메인을 지정하려면 URI 접두 http://*.foo.com/사에서 호스트 이름의 일부로 "*" 문자를 사용하고 HttpListenerPrefixCollection.Add 메서드에 인수로 전달합니다. .NET 4.5.3 및 Windows 10에서 작동합니다. 이전 버전에서는 이 을 생성합니다. HttpListenerException
적용 대상
추가 정보
.NET