Ping.Send 메서드

참조

정의

네임스페이스:: System.Net.NetworkInformation

어셈블리:: System.Net.Ping.dll

어셈블리:: System.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

원격 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지를 보내고 해당 원격 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다.

오버로드

Send(String, TimeSpan, Byte[], PingOptions)	지정된 컴퓨터에 ICMP(인터넷 제어 메시지 프로토콜) 에코 메시지를 보내고 해당 컴퓨터에서 해당 ICMP 에코 회신 메시지를 수신하려고 시도합니다.
Send(String, Int32, Byte[], PingOptions)	지정된 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지와 지정된 데이터 버퍼를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다. 이 오버로드를 사용하여 작업의 제한 시간 값을 지정하고 ICMP 패킷의 조각화 및 Time-to-Live 값을 제어할 수 있습니다.
Send(IPAddress, TimeSpan, Byte[], PingOptions)	지정된 IPAddress가 있는 컴퓨터에 ICMP(인터넷 제어 메시지 프로토콜) 에코 메시지를 보내고 해당 컴퓨터에서 해당 ICMP 에코 회신 메시지를 수신하려고 시도합니다.
Send(IPAddress, Int32, Byte[], PingOptions)	지정된 IPAddress를 사용하는 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지와 지정된 데이터 버퍼를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다. 이 오버로드를 사용하여 작업의 제한 시간 값을 지정하고 ICMP Echo 메시지 패킷의 조각화 및 Time-to-Live 값을 제어할 수 있습니다.
Send(String, Int32, Byte[])	지정된 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지와 지정된 데이터 버퍼를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다. 이 오버로드를 통해 작업의 시간 제한 값을 지정할 수 있습니다.
Send(IPAddress, Int32, Byte[])	지정된 IPAddress를 사용하는 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지와 지정된 데이터 버퍼를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다. 이 오버로드를 통해 작업의 시간 제한 값을 지정할 수 있습니다.
Send(String, Int32)	지정된 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다. 이 메서드를 통해 작업의 시간 제한 값을 지정할 수 있습니다.
Send(IPAddress, Int32)	지정된 IPAddress를 사용하는 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지와 지정된 데이터 버퍼를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다. 이 메서드를 통해 작업의 시간 제한 값을 지정할 수 있습니다.
Send(String)	지정된 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다.
Send(IPAddress)	지정된 IPAddress를 사용하는 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다.

설명

오버로드에서 Send 반환된 IP 주소는 악의적인 원격 컴퓨터에서 발생할 수 있습니다. 이를 사용하여 원격 컴퓨터에 연결하지 마세요. DNS를 사용하여 연결할 컴퓨터의 IP 주소를 확인합니다.

Send(String, TimeSpan, Byte[], PingOptions)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

지정된 컴퓨터에 ICMP(인터넷 제어 메시지 프로토콜) 에코 메시지를 보내고 해당 컴퓨터에서 해당 ICMP 에코 회신 메시지를 수신하려고 시도합니다.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress, TimeSpan timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);

public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, TimeSpan timeout, byte[]? buffer, System.Net.NetworkInformation.PingOptions? options);

member this.Send : string * TimeSpan * byte[] * System.Net.NetworkInformation.PingOptions -> System.Net.NetworkInformation.PingReply

Public Function Send (hostNameOrAddress As String, timeout As TimeSpan, buffer As Byte(), options As PingOptions) As PingReply

매개 변수

hostNameOrAddress: String

ICMP Echo 메시지의 대상 컴퓨터를 식별하는 String입니다. 이 매개 변수에 지정된 값은 호스트 이름 또는 IP 주소의 문자열 표현일 수 있습니다.

timeout: TimeSpan

ICMP 에코 회신 메시지를 대기할 최대 시간(에코 메시지를 보낸 후)을 지정하는 값입니다.

buffer: Byte[]

ICMP Echo 메시지와 함께 보내지고 ICMP Echo Reply 메시지에 담겨 반환되는 데이터가 포함된 Byte 배열입니다. 배열은 65,500바이트를 초과할 수 없습니다.

options: PingOptions

ICMP Echo 메시지 패킷의 조각화 및 Time-to-Live 값을 제어하는 데 사용되는 PingOptions 개체입니다.

반환

PingReply

ICMP 에코 회신 메시지에 대한 정보, 메시지가 수신된 경우 또는 메시지가 수신되지 않은 경우 실패 원인입니다.

예외

ArgumentNullException

buffer 또는 hostNameOrAddress 가 null 또는 hostNameOrAddress 가 빈 문자열("")입니다.

ArgumentOutOfRangeException

timeout 는 0밀리초 미만 또는 밀리초보다 MaxValue 큰 시간을 나타냅니다.

ArgumentException

buffer의 크기가 65,500바이트보다 큽니다.

InvalidOperationException

SendAsync 호출이 진행 중입니다.

PingException

ICMP 메시지를 보내거나 받는 동안 예외가 throw된 경우. throw된 정확한 예외에 대해서는 내부 예외를 참조하십시오.

ObjectDisposedException

이 개체가 삭제되었습니다.

적용 대상

Send(String, Int32, Byte[], PingOptions)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

지정된 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지와 지정된 데이터 버퍼를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다. 이 오버로드를 사용하여 작업의 제한 시간 값을 지정하고 ICMP 패킷의 조각화 및 Time-to-Live 값을 제어할 수 있습니다.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);

public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions? options);

public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options);

member this.Send : string * int * byte[] * System.Net.NetworkInformation.PingOptions -> System.Net.NetworkInformation.PingReply

Public Function Send (hostNameOrAddress As String, timeout As Integer, buffer As Byte(), options As PingOptions) As PingReply

매개 변수

hostNameOrAddress: String

ICMP Echo 메시지의 대상 컴퓨터를 식별하는 String입니다. 이 매개 변수에 지정된 값은 호스트 이름 또는 IP 주소의 문자열 표현일 수 있습니다.

timeout: Int32

ICMP Echo 메시지를 보낸 후 ICMP Echo Reply 메시지를 기다리는 최대 시간(밀리초)을 지정하는 Int32 값입니다.

buffer: Byte[]

ICMP Echo 메시지와 함께 보내지고 ICMP Echo Reply 메시지에 담겨 반환되는 데이터가 포함된 Byte 배열입니다. 배열은 65,500바이트를 초과할 수 없습니다.

options: PingOptions

ICMP Echo 메시지 패킷의 조각화 및 Time-to-Live 값을 제어하는 데 사용되는 PingOptions 개체입니다.

반환

PingReply

ICMP Echo Reply 메시지를 받은 경우 이 메시지에 대한 정보를 제공하고 메시지를 받지 못한 경우에는 오류의 원인을 제공하는 PingReply 개체입니다.

예외

ArgumentException

buffer의 크기가 65500바이트를 초과하는 경우

ArgumentNullException

hostNameOrAddress는 null 또는 길이가 0인 문자열입니다.

또는

buffer은 null입니다.

ArgumentOutOfRangeException

timeout가 0보다 작은 경우

InvalidOperationException

SendAsync를 호출하고 있는 경우

PingException

ICMP 메시지를 보내거나 받는 동안 예외가 throw된 경우. throw된 정확한 예외에 대해서는 내부 예외를 참조하십시오.

ObjectDisposedException

이 개체가 삭제되었습니다.

PlatformNotSupportedException

Linux에서만 .NET 7 이상 버전: 프로세스가 권한이 없으며 buffer 비어 있지 않습니다.

예제

다음 코드 예제에서는이 메서드를 호출 하는 방법을 보여 줍니다.

void ComplexPing()
{
   Ping ^ pingSender = gcnew Ping;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   
   // Wait 10 seconds for a reply.
   int timeout = 10000;
   
   // Set options for transmission:
   // The data can go through 64 gateways or routers
   // before it is destroyed, and the data packet
   // cannot be fragmented.
   PingOptions ^ options = gcnew PingOptions( 64,true );
   
   // Send the request.
   PingReply ^ reply = pingSender->Send( "www.contoso.com", timeout, buffer, options );
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}

public static void ComplexPing ()
{
    Ping pingSender = new Ping ();

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;

    // Set options for transmission:
    // The data can go through 64 gateways or routers
    // before it is destroyed, and the data packet
    // cannot be fragmented.
    PingOptions options = new PingOptions (64, true);

    // Send the request.
    PingReply reply = pingSender.Send ("www.contoso.com", timeout, buffer, options);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

설명

매개 변수로 지정된 timeout 시간 내에 ICMP 에코 회신 메시지를 받지 못하면 ICMP 에코가 실패하고 Status 속성이 로 TimedOut설정됩니다.

참고

에 timeout대해 매우 작은 숫자를 지정할 때 밀리초가 경과한 경우에도 timeout Ping 회신을 받을 수 있습니다.

속성이 DontFragment 이 true 고 총 패킷 크기가 로컬 컴퓨터와 원격 컴퓨터 간의 라우팅 노드 중 하나에서 전송할 수 있는 최대 패킷 크기를 초과하는 경우 ICMP 에코 요청이 실패합니다. 이 경우 는 Status 로 설정됩니다 PacketTooBig.

사용 된 대상에 Ttl 도달 하기 전에 ICMP 에코 메시지를 전달할 수 있는 최대 횟수를 지정 하는 속성입니다. 지정된 횟수를 전달한 후 패킷이 대상에 도달하지 않으면 패킷이 삭제되고 ICMP 에코 요청이 실패합니다. 이 경우 는 Status 로 설정됩니다 TtlExpired.

적용 대상

Send(IPAddress, TimeSpan, Byte[], PingOptions)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

지정된 IPAddress가 있는 컴퓨터에 ICMP(인터넷 제어 메시지 프로토콜) 에코 메시지를 보내고 해당 컴퓨터에서 해당 ICMP 에코 회신 메시지를 수신하려고 시도합니다.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address, TimeSpan timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);

public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, TimeSpan timeout, byte[]? buffer, System.Net.NetworkInformation.PingOptions? options);

member this.Send : System.Net.IPAddress * TimeSpan * byte[] * System.Net.NetworkInformation.PingOptions -> System.Net.NetworkInformation.PingReply

Public Function Send (address As IPAddress, timeout As TimeSpan, buffer As Byte(), options As PingOptions) As PingReply

매개 변수

address: IPAddress

ICMP Echo 메시지의 대상 컴퓨터를 식별하는 IPAddress입니다.

timeout: TimeSpan

ICMP 에코 회신 메시지를 대기할 최대 시간(에코 메시지를 보낸 후)을 지정하는 값입니다.

buffer: Byte[]

ICMP Echo 메시지와 함께 보내지고 ICMP Echo Reply 메시지에 담겨 반환되는 데이터가 포함된 Byte 배열입니다. 배열은 65,500바이트를 초과할 수 없습니다.

options: PingOptions

ICMP Echo 메시지 패킷의 조각화 및 Time-to-Live 값을 제어하는 데 사용되는 PingOptions 개체입니다.

반환

PingReply

ICMP 에코 회신 메시지에 대한 정보, 메시지가 수신된 경우 또는 메시지가 수신되지 않은 경우 실패 원인입니다.

예외

ArgumentNullException

address 또는 buffer가 null인 경우

ArgumentOutOfRangeException

timeout 는 0밀리초 미만 또는 밀리초보다 MaxValue 큰 시간을 나타냅니다.

ArgumentException

buffer의 크기가 65,500바이트보다 큽니다.

InvalidOperationException

SendAsync 호출이 진행 중입니다.

PingException

ICMP 메시지를 보내거나 받는 동안 예외가 throw된 경우. throw된 정확한 예외에 대해서는 내부 예외를 참조하십시오.

ObjectDisposedException

이 개체가 삭제되었습니다.

적용 대상

Send(IPAddress, Int32, Byte[], PingOptions)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

지정된 IPAddress를 사용하는 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지와 지정된 데이터 버퍼를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다. 이 오버로드를 사용하여 작업의 제한 시간 값을 지정하고 ICMP Echo 메시지 패킷의 조각화 및 Time-to-Live 값을 제어할 수 있습니다.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);

public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions? options);

public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options);

member this.Send : System.Net.IPAddress * int * byte[] * System.Net.NetworkInformation.PingOptions -> System.Net.NetworkInformation.PingReply

Public Function Send (address As IPAddress, timeout As Integer, buffer As Byte(), options As PingOptions) As PingReply

매개 변수

address: IPAddress

ICMP Echo 메시지의 대상 컴퓨터를 식별하는 IPAddress입니다.

timeout: Int32

ICMP Echo 메시지를 보낸 후 ICMP Echo Reply 메시지를 기다리는 최대 시간(밀리초)을 지정하는 Int32 값입니다.

buffer: Byte[]

ICMP Echo 메시지와 함께 보내지고 ICMP Echo Reply 메시지에 담겨 반환되는 데이터가 포함된 Byte 배열입니다. 배열은 65,500바이트를 초과할 수 없습니다.

options: PingOptions

ICMP Echo 메시지 패킷의 조각화 및 Time-to-Live 값을 제어하는 데 사용되는 PingOptions 개체입니다.

반환

PingReply

ICMP Echo Reply 메시지를 받은 경우 이 메시지에 대한 정보를 제공하고 메시지를 받지 못한 경우에는 오류의 원인을 제공하는 PingReply 개체입니다. 이 메서드는 패킷이 MTU(최대 전송 단위)를 초과할 경우 PacketTooBig을 반환합니다.

예외

ArgumentException

buffer의 크기가 65500바이트를 초과하는 경우

ArgumentNullException

address 또는 buffer가 null인 경우

ArgumentOutOfRangeException

timeout가 0보다 작은 경우

InvalidOperationException

SendAsync를 호출하고 있는 경우

PingException

ICMP 메시지를 보내거나 받는 동안 예외가 throw된 경우. throw된 정확한 예외에 대해서는 내부 예외를 참조하십시오.

ObjectDisposedException

이 개체가 삭제되었습니다.

PlatformNotSupportedException

Linux에서만 .NET 7 이상 버전: 프로세스가 권한이 없으며 buffer 비어 있지 않습니다.

예제

다음 코드 예제에서는이 메서드를 호출 하는 방법을 보여 줍니다.

void ComplexLocalPing()
{
   
   // Ping's the local machine.
   Ping ^ pingSender = gcnew Ping;
   IPAddress^ address = IPAddress::Loopback;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   
   // Wait 10 seconds for a reply.
   int timeout = 10000;
   
   // Set options for transmission:
   // The data can go through 64 gateways or routers
   // before it is destroyed, and the data packet
   // cannot be fragmented.
   PingOptions ^ options = gcnew PingOptions( 64,true );
   PingReply ^ reply = pingSender->Send( address, timeout, buffer, options );
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}

public static void ComplexLocalPing ()
{
    // Ping's the local machine.
    Ping pingSender = new Ping ();
    IPAddress address = IPAddress.Loopback;

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;

    // Set options for transmission:
    // The data can go through 64 gateways or routers
    // before it is destroyed, and the data packet
    // cannot be fragmented.
    PingOptions options = new PingOptions (64, true);
    PingReply reply = pingSender.Send (address, timeout, buffer, options);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

설명

매개 변수에 지정된 timeout 시간 내에 ICMP 에코 회신 메시지를 받지 못하면 ICMP 에코가 실패하고 Status 속성이 로 TimedOut설정됩니다.

참고

에 timeout매우 작은 숫자를 지정할 때 밀리초가 경과한 경우에도 timeout Ping 회신을 받을 수 있습니다.

속성이 DontFragment 이 true 고 총 패킷 크기가 로컬 및 원격 컴퓨터 간의 라우팅 노드 중 하나에서 전송할 수 있는 최대 패킷 크기를 초과하는 경우 ICMP 에코 요청이 실패합니다. 이 경우 는 Status 로 설정 PacketTooBig됩니다.

사용 된 Ttl ICMP 에코 메시지를 전달 될 수 있는 최대 횟수를 지정 하는 속성 대상에 도달 하기 전에 합니다. 패킷이 지정된 횟수만큼 전달된 후 대상에 도달하지 않으면 패킷이 삭제되고 ICMP 에코 요청이 실패합니다. 이 경우 는 Status 로 설정 TtlExpired됩니다.

적용 대상

Send(String, Int32, Byte[])

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

지정된 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지와 지정된 데이터 버퍼를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다. 이 오버로드를 통해 작업의 시간 제한 값을 지정할 수 있습니다.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer);

public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, int timeout, byte[] buffer);

member this.Send : string * int * byte[] -> System.Net.NetworkInformation.PingReply

Public Function Send (hostNameOrAddress As String, timeout As Integer, buffer As Byte()) As PingReply

매개 변수

hostNameOrAddress: String

ICMP Echo 메시지의 대상 컴퓨터를 식별하는 String입니다. 이 매개 변수에 지정된 값은 호스트 이름 또는 IP 주소의 문자열 표현일 수 있습니다.

timeout: Int32

ICMP Echo 메시지를 보낸 후 ICMP Echo Reply 메시지를 기다리는 최대 시간(밀리초)을 지정하는 Int32 값입니다.

buffer: Byte[]

ICMP Echo 메시지와 함께 보내지고 ICMP Echo Reply 메시지에 담겨 반환되는 데이터가 포함된 Byte 배열입니다. 배열은 65,500바이트를 초과할 수 없습니다.

반환

PingReply

ICMP Echo Reply 메시지를 받은 경우 이 메시지에 대한 정보를 제공하고 메시지를 받지 못한 경우에는 오류의 원인을 제공하는 PingReply 개체입니다.

예외

ArgumentException

buffer의 크기가 65500바이트를 초과하는 경우

ArgumentNullException

hostNameOrAddress이 null이거나 빈 문자열("")인 경우

또는

buffer은 null입니다.

ArgumentOutOfRangeException

timeout가 0보다 작은 경우

InvalidOperationException

SendAsync를 호출하고 있는 경우

PingException

ICMP 메시지를 보내거나 받는 동안 예외가 throw된 경우. throw된 정확한 예외에 대해서는 내부 예외를 참조하십시오.

ObjectDisposedException

이 개체가 삭제되었습니다.

PlatformNotSupportedException

Linux에서만 .NET 7 이상 버전: 프로세스가 권한이 없으며 buffer 비어 있지 않습니다.

예제

오버로드를 호출하는 방법을 보여 주는 예제는 Send 클래스 개요를 Ping 참조하세요.

설명

매개 변수에 지정된 timeout 시간 내에 ICMP 에코 회신 메시지를 받지 못하면 ICMP 에코가 실패하고 Status 속성이 로 TimedOut설정됩니다.

참고

에 timeout매우 작은 숫자를 지정할 때 밀리초가 경과한 경우에도 timeout Ping 회신을 받을 수 있습니다.

패킷 또는 패킷 조각은 삭제되기 전에 노드를 128번 라우팅하여 전달할 수 있습니다. 이 설정을 변경하려면 매개 변수를 Send 사용하는 오버로드를 options 사용하고 속성을 원하는 값으로 설정합니다 Ttl . 패킷이 지정된 횟수만큼 전달된 후 대상에 도달하지 않으면 패킷이 삭제되고 ICMP 에코 요청이 실패합니다. 이 경우 는 Status 로 설정 TtlExpired됩니다.

적용 대상

Send(IPAddress, Int32, Byte[])

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

지정된 IPAddress를 사용하는 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지와 지정된 데이터 버퍼를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다. 이 오버로드를 통해 작업의 시간 제한 값을 지정할 수 있습니다.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer);

public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, int timeout, byte[] buffer);

member this.Send : System.Net.IPAddress * int * byte[] -> System.Net.NetworkInformation.PingReply

Public Function Send (address As IPAddress, timeout As Integer, buffer As Byte()) As PingReply

매개 변수

address: IPAddress

ICMP Echo 메시지의 대상 컴퓨터를 식별하는 IPAddress입니다.

timeout: Int32

ICMP Echo 메시지를 보낸 후 ICMP Echo Reply 메시지를 기다리는 최대 시간(밀리초)을 지정하는 Int32 값입니다.

buffer: Byte[]

ICMP Echo 메시지와 함께 보내지고 ICMP Echo Reply 메시지에 담겨 반환되는 데이터가 포함된 Byte 배열입니다. 배열은 65,500바이트를 초과할 수 없습니다.

반환

PingReply

예외

ArgumentException

buffer의 크기가 65500바이트를 초과하는 경우

ArgumentNullException

address 또는 buffer가 null인 경우

ArgumentOutOfRangeException

timeout가 0보다 작은 경우

InvalidOperationException

SendAsync를 호출하고 있는 경우

PingException

ICMP 메시지를 보내거나 받는 동안 예외가 throw된 경우. throw된 정확한 예외에 대해서는 내부 예외를 참조하십시오.

ObjectDisposedException

이 개체가 삭제되었습니다.

PlatformNotSupportedException

Linux에서만 .NET 7 이상 버전: 프로세스가 권한이 없으며 buffer 비어 있지 않습니다.

예제

다음 코드 예제에서는이 메서드를 호출 하는 방법을 보여 줍니다.

void LocalPingTimeout()
{
   
   // Ping's the local machine.
   Ping ^ pingSender = gcnew Ping;
   IPAddress^ address = IPAddress::Loopback;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   
   // Wait 10 seconds for a reply.
   int timeout = 10000;
   PingReply ^ reply = pingSender->Send( address, timeout, buffer);
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}

public static void LocalPingTimeout ()
{
    // Ping's the local machine.
    Ping pingSender = new Ping ();
    IPAddress address = IPAddress.Loopback;

    // Create a buffer of 32 bytes of data to be transmitted.
    string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
    byte[] buffer = Encoding.ASCII.GetBytes (data);

    // Wait 10 seconds for a reply.
    int timeout = 10000;
    PingReply reply = pingSender.Send (address, timeout, buffer);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

설명

매개 변수에 지정된 timeout 시간 내에 ICMP 에코 회신 메시지를 받지 못하면 ICMP 에코가 실패하고 Status 속성이 로 TimedOut설정됩니다.

참고

에 timeout매우 작은 숫자를 지정할 때 밀리초가 경과한 경우에도 timeout Ping 회신을 받을 수 있습니다.

적용 대상

Send(String, Int32)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

지정된 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다. 이 메서드를 통해 작업의 시간 제한 값을 지정할 수 있습니다.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress, int timeout);

public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress, int timeout);

member this.Send : string * int -> System.Net.NetworkInformation.PingReply

Public Function Send (hostNameOrAddress As String, timeout As Integer) As PingReply

매개 변수

hostNameOrAddress: String

ICMP Echo 메시지의 대상 컴퓨터를 식별하는 String입니다. 이 매개 변수에 지정된 값은 호스트 이름 또는 IP 주소의 문자열 표현일 수 있습니다.

timeout: Int32

ICMP Echo 메시지를 보낸 후 ICMP Echo Reply 메시지를 기다리는 최대 시간(밀리초)을 지정하는 Int32 값입니다.

반환

PingReply

ICMP Echo Reply 메시지를 받은 경우 이 메시지에 대한 정보를 제공하고 메시지를 받지 못한 경우에는 오류의 원인을 제공하는 PingReply 개체입니다.

예외

ArgumentNullException

hostNameOrAddress이 null이거나 빈 문자열("")인 경우

ArgumentOutOfRangeException

timeout가 0보다 작은 경우

InvalidOperationException

SendAsync를 호출하고 있는 경우

PingException

ICMP 메시지를 보내거나 받는 동안 예외가 throw된 경우. throw된 정확한 예외에 대해서는 내부 예외를 참조하십시오.

ObjectDisposedException

이 개체가 삭제되었습니다.

예제

메서드 호출을 보여 주는 예제는 Send 클래스 개요를 Ping 참조하세요.

설명

매개 변수에 지정된 timeout 시간 내에 ICMP 에코 회신 메시지를 받지 못하면 ICMP 에코가 실패하고 Status 속성이 로 TimedOut설정됩니다.

참고

에 timeout매우 작은 숫자를 지정할 때 밀리초가 경과한 경우에도 timeout Ping 회신을 받을 수 있습니다.

이 오버로드는 패킷 조각화 및 패킷 전달에 기본 설정을 사용합니다. 총 패킷 크기가 로컬 및 원격 컴퓨터 간의 라우팅 노드 중 하나에서 전송할 수 있는 최대 패킷 크기를 초과하는 경우 ICMP 에코 메시지를 포함하는 패킷은 전송 중에 조각화될 수 있습니다. 조각화를 방지하려면 매개 변수를 Send 사용하는 options 메서드 중 하나를 사용하고 속성을 true로 설정합니다DontFragment. DontFragment 가 true 이고 총 패킷 크기가 로컬 및 원격 컴퓨터 간의 라우팅 노드 중 하나에서 전송할 수 있는 최대 패킷 크기를 초과하면 ICMP 에코 요청이 실패합니다. 이 경우 는 Status 로 설정 PacketTooBig됩니다. 패킷 또는 패킷 조각(조각화된 경우)은 삭제되기 전에 노드를 128번 라우팅하여 전달할 수 있습니다. 이 설정을 변경하려면 매개 변수를 Send 사용하는 오버로드를 options 사용하고 속성을 원하는 값으로 설정합니다 Ttl . 지정된 횟수를 전달한 후 패킷이 대상에 도달하지 않으면 패킷이 삭제되고 ICMP 에코 요청이 실패합니다. 이 경우 는 Status 로 설정됩니다 TtlExpired.

적용 대상

Send(IPAddress, Int32)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

지정된 IPAddress를 사용하는 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지와 지정된 데이터 버퍼를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다. 이 메서드를 통해 작업의 시간 제한 값을 지정할 수 있습니다.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address, int timeout);

public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address, int timeout);

member this.Send : System.Net.IPAddress * int -> System.Net.NetworkInformation.PingReply

Public Function Send (address As IPAddress, timeout As Integer) As PingReply

매개 변수

address: IPAddress

ICMP Echo 메시지의 대상 컴퓨터를 식별하는 IPAddress입니다.

timeout: Int32

ICMP Echo 메시지를 보낸 후 ICMP Echo Reply 메시지를 기다리는 최대 시간(밀리초)을 지정하는 Int32 값입니다.

반환

PingReply

ICMP Echo Reply 메시지를 받은 경우 이 메시지에 대한 정보를 제공하고 메시지를 받지 못한 경우에는 오류의 원인을 제공하는 PingReply 개체입니다.

예외

ArgumentNullException

address이(가) null인 경우

ArgumentOutOfRangeException

timeout가 0보다 작은 경우

InvalidOperationException

SendAsync를 호출하고 있는 경우

PingException

ICMP 메시지를 보내거나 받는 동안 예외가 throw된 경우. throw된 정확한 예외에 대해서는 내부 예외를 참조하십시오.

ObjectDisposedException

이 개체가 삭제되었습니다.

예제

메서드 호출을 보여 주는 예제는 Send 클래스 개요를 Ping 참조하세요.

설명

매개 변수에 지정된 timeout 시간 내에 ICMP 에코 회신 메시지를 받지 못하면 ICMP 에코가 실패하고 Status 속성이 로 TimedOut설정됩니다.

참고

에 timeout대해 매우 작은 숫자를 지정할 때 밀리초가 경과한 경우에도 timeout Ping 회신을 받을 수 있습니다.

패킷 또는 패킷 조각은 삭제되기 전에 노드를 128번 라우팅하여 전달할 수 있습니다. 이 설정을 변경하려면 매개 변수를 Send 사용하는 오버로드를 options 사용하고 속성을 원하는 값으로 설정합니다 Ttl . 지정된 횟수를 전달한 후 패킷이 대상에 도달하지 않으면 패킷이 삭제되고 ICMP 에코 요청이 실패합니다. 이 경우 는 Status 로 설정됩니다 TtlExpired.

적용 대상

Send(String)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

지정된 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::String ^ hostNameOrAddress);

public System.Net.NetworkInformation.PingReply Send (string hostNameOrAddress);

member this.Send : string -> System.Net.NetworkInformation.PingReply

Public Function Send (hostNameOrAddress As String) As PingReply

매개 변수

hostNameOrAddress: String

ICMP Echo 메시지의 대상 컴퓨터를 식별하는 String입니다. 이 매개 변수에 지정된 값은 호스트 이름 또는 IP 주소의 문자열 표현일 수 있습니다.

반환

PingReply

ICMP Echo Reply 메시지를 받은 경우 이 메시지에 대한 정보를 제공하고 메시지를 받지 못한 경우에는 오류의 원인을 제공하는 PingReply 개체입니다.

예외

ArgumentNullException

hostNameOrAddress이 null이거나 빈 문자열("")인 경우

InvalidOperationException

SendAsync를 호출하고 있는 경우

PingException

ICMP 메시지를 보내거나 받는 동안 예외가 throw된 경우. throw된 정확한 예외에 대해서는 내부 예외를 참조하십시오.

ObjectDisposedException

이 개체가 삭제되었습니다.

예제

다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

void SimplePing()
{
   Ping ^ pingSender = gcnew Ping;
   PingReply ^ reply = pingSender->Send( "www.contoso.com" );
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}

public static void SimplePing ()
{
    Ping pingSender = new Ping ();
    PingReply reply = pingSender.Send ("www.contoso.com");

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

설명

이 메서드는 ICMP 에코 메시지와 함께 32 Byte 데이터 버퍼를 보냅니다. 메서드는 ICMP 에코 응답 메시지를 5초 동안 기다립니다. 해당 시간에 회신을 받지 못하면 메서드가 를 반환하고 속성이 Status 로 TimedOut설정됩니다.

이 오버로드는 패킷 조각화 및 패킷 전달에 기본 설정을 사용합니다. 총 패킷 크기가 로컬 및 원격 컴퓨터 간의 라우팅 노드 중 하나에서 전송할 수 있는 최대 패킷 크기를 초과하는 경우 ICMP 에코 메시지를 포함하는 패킷을 전송 중에 조각화할 수 있습니다. 조각화를 방지하려면 매개 변수를 Send 사용하는 options 메서드 중 하나를 사용하고 속성을 true로 설정합니다DontFragment. 가 true 이고 총 패킷 크기가 로컬 컴퓨터와 원격 컴퓨터 간의 라우팅 노드 중 하나에서 전송할 수 있는 최대 패킷 크기를 초과하는 경우 DontFragment ICMP 에코 요청이 실패합니다. 이 경우 는 Status 로 설정됩니다 PacketTooBig. 패킷 또는 패킷 조각(조각화된 경우)은 삭제되기 전에 노드를 128번 라우팅하여 전달할 수 있습니다. 이 설정을 변경하려면 매개 변수를 Send 사용하는 오버로드를 options 사용하고 속성을 원하는 값으로 설정합니다 Ttl . 지정된 횟수를 전달한 후 패킷이 대상에 도달하지 않으면 패킷이 삭제되고 ICMP 에코 요청이 실패합니다. 이 경우 는 Status 로 설정됩니다 TtlExpired.

적용 대상

Send(IPAddress)

Source:: Ping.cs

Source:: Ping.cs

Source:: Ping.cs

지정된 IPAddress를 사용하는 컴퓨터에 ICMP(Internet Control Message Protocol) Echo 메시지를 보내고 해당 컴퓨터로부터 이에 대응하는 ICMP Echo Reply 메시지를 받으려고 시도합니다.

public:
 System::Net::NetworkInformation::PingReply ^ Send(System::Net::IPAddress ^ address);

public System.Net.NetworkInformation.PingReply Send (System.Net.IPAddress address);

member this.Send : System.Net.IPAddress -> System.Net.NetworkInformation.PingReply

Public Function Send (address As IPAddress) As PingReply

매개 변수

address: IPAddress

ICMP Echo 메시지의 대상 컴퓨터를 식별하는 IPAddress입니다.

반환

PingReply

ICMP Echo Reply 메시지를 받은 경우 이 메시지에 대한 정보를 제공하고 메시지를 받지 못한 경우에는 오류의 원인을 설명하는 PingReply 개체입니다.

예외

ArgumentNullException

address이(가) null인 경우

InvalidOperationException

SendAsync를 호출하고 있는 경우

PingException

ICMP 메시지를 보내거나 받는 동안 예외가 throw된 경우. throw된 정확한 예외에 대해서는 내부 예외를 참조하십시오.

ObjectDisposedException

이 개체가 삭제되었습니다.

예제

다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

void LocalPing()
{
   
   // Ping's the local machine.
   Ping ^ pingSender = gcnew Ping;
   IPAddress^ address = IPAddress::Loopback;
   PingReply ^ reply = pingSender->Send( address );
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }
   else
   {
      Console::WriteLine( reply->Status );
   }
}

public static void LocalPing ()
{
    // Ping's the local machine.
    Ping pingSender = new Ping ();
    IPAddress address = IPAddress.Loopback;
    PingReply reply = pingSender.Send (address);

    if (reply.Status == IPStatus.Success)
    {
        Console.WriteLine ("Address: {0}", reply.Address.ToString ());
        Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
        Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
        Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
        Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
    }
    else
    {
        Console.WriteLine (reply.Status);
    }
}

설명

이 메서드는 ICMP 에코 메시지를 사용하여 32 Byte 데이터 버퍼로 지정된 address 호스트로 보냅니다. 메서드는 ICMP 에코 응답 메시지를 5초 동안 기다립니다. 해당 시간에 회신을 받지 못하면 메서드가 를 반환하고 속성이 Status 로 TimedOut설정됩니다.

적용 대상

다음을 통해 공유

Ping.Send 메서드

정의

오버로드

설명

Send(String, TimeSpan, Byte[], PingOptions)

매개 변수

반환

예외

적용 대상

Send(String, Int32, Byte[], PingOptions)

매개 변수

반환

예외

예제

설명

적용 대상

Send(IPAddress, TimeSpan, Byte[], PingOptions)

매개 변수

반환

예외

적용 대상

Send(IPAddress, Int32, Byte[], PingOptions)

매개 변수

반환

예외

예제

설명

적용 대상

Send(String, Int32, Byte[])

매개 변수

반환

예외

예제

설명

적용 대상

Send(IPAddress, Int32, Byte[])

매개 변수

반환

예외

예제

설명

적용 대상

Send(String, Int32)

매개 변수

반환

예외

예제

설명

적용 대상

Send(IPAddress, Int32)

매개 변수

반환

예외

예제

설명

적용 대상

Send(String)

매개 변수

반환

예외

예제

설명

적용 대상

Send(IPAddress)

매개 변수

반환

예외

예제

설명

적용 대상

추가 리소스