IPAddress Osztály

Definíció

Névtér:: System.Net

Szerelvények:: System.dll, System.Net.Primitives.dll

Szerelvények:: netstandard.dll, System.Net.Primitives.dll

Szerelvény:: System.Net.Primitives.dll

Szerelvény:: System.dll

Szerelvény:: netstandard.dll

Forrás:: IPAddress.cs

Forrás:: IPAddress.cs

Forrás:: IPAddress.cs

Forrás:: IPAddress.cs

Forrás:: IPAddress.cs

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Ip-címet biztosít.

public ref class IPAddress

public ref class IPAddress : IParsable<System::Net::IPAddress ^>, ISpanFormattable, ISpanParsable<System::Net::IPAddress ^>, IUtf8SpanFormattable, IUtf8SpanParsable<System::Net::IPAddress ^>

public ref class IPAddress : IParsable<System::Net::IPAddress ^>, ISpanFormattable, ISpanParsable<System::Net::IPAddress ^>, IUtf8SpanFormattable

public class IPAddress

public class IPAddress : IParsable<System.Net.IPAddress>, ISpanFormattable, ISpanParsable<System.Net.IPAddress>, IUtf8SpanFormattable, IUtf8SpanParsable<System.Net.IPAddress>

public class IPAddress : IParsable<System.Net.IPAddress>, ISpanFormattable, ISpanParsable<System.Net.IPAddress>, IUtf8SpanFormattable

[System.Serializable]
public class IPAddress

type IPAddress = class

type IPAddress = class
    interface ISpanFormattable
    interface IFormattable
    interface ISpanParsable<IPAddress>
    interface IParsable<IPAddress>
    interface IUtf8SpanFormattable
    interface IUtf8SpanParsable<IPAddress>

type IPAddress = class
    interface ISpanFormattable
    interface IFormattable
    interface ISpanParsable<IPAddress>
    interface IParsable<IPAddress>
    interface IUtf8SpanFormattable

[<System.Serializable>]
type IPAddress = class

Public Class IPAddress

Public Class IPAddress
Implements IParsable(Of IPAddress), ISpanFormattable, ISpanParsable(Of IPAddress), IUtf8SpanFormattable, IUtf8SpanParsable(Of IPAddress)

Public Class IPAddress
Implements IParsable(Of IPAddress), ISpanFormattable, ISpanParsable(Of IPAddress), IUtf8SpanFormattable

Öröklődés: Object
IPAddress

Attribútumok: SerializableAttribute

Megvalósítás: IFormattable IParsable<IPAddress> IParsable<TSelf> ISpanFormattable ISpanParsable<IPAddress> IUtf8SpanFormattable IUtf8SpanParsable<IPAddress>

Példák

Az alábbi példakód bemutatja, hogyan kérdezhet le egy kiszolgálót a családi címek és az általa támogatott IP-címek lekéréséhez.


// This program shows how to use the IPAddress class to obtain a server
// IP addressess and related information.

using System;
using System.Net;
using System.Net.Sockets;
using System.Text.RegularExpressions;

namespace Mssc.Services.ConnectionManagement
{

  class TestIPAddress
  {

    /**
      * The IPAddresses method obtains the selected server IP address information.
      * It then displays the type of address family supported by the server and its
      * IP address in standard and byte format.
      **/
    private static void IPAddresses(string server)
    {
      try
      {
        System.Text.ASCIIEncoding ASCII = new System.Text.ASCIIEncoding();

        // Get server related information.
        IPHostEntry heserver = Dns.GetHostEntry(server);

        // Loop on the AddressList
        foreach (IPAddress curAdd in heserver.AddressList)
        {


          // Display the type of address family supported by the server. If the
          // server is IPv6-enabled this value is: InterNetworkV6. If the server
          // is also IPv4-enabled there will be an additional value of InterNetwork.
          Console.WriteLine("AddressFamily: " + curAdd.AddressFamily.ToString());

          // Display the ScopeId property in case of IPV6 addresses.
          if(curAdd.AddressFamily.ToString() == ProtocolFamily.InterNetworkV6.ToString())
            Console.WriteLine("Scope Id: " + curAdd.ScopeId.ToString());


          // Display the server IP address in the standard format. In
          // IPv4 the format will be dotted-quad notation, in IPv6 it will be
          // in in colon-hexadecimal notation.
          Console.WriteLine("Address: " + curAdd.ToString());

          // Display the server IP address in byte format.
          Console.Write("AddressBytes: ");

          Byte[] bytes = curAdd.GetAddressBytes();
          for (int i = 0; i < bytes.Length; i++)
          {
            Console.Write(bytes[i]);
          }

          Console.WriteLine("\r\n");
        }
      }
      catch (Exception e)
      {
        Console.WriteLine("[DoResolve] Exception: " + e.ToString());
      }
    }

    // This IPAddressAdditionalInfo displays additional server address information.
    private static void IPAddressAdditionalInfo()
    {
      try
      {
        // Display the flags that show if the server supports IPv4 or IPv6
        // address schemas.
        Console.WriteLine("\r\nSupportsIPv4: " + Socket.SupportsIPv4);
        Console.WriteLine("SupportsIPv6: " + Socket.SupportsIPv6);

        if (Socket.SupportsIPv6)
        {
          // Display the server Any address. This IP address indicates that the server
          // should listen for client activity on all network interfaces.
          Console.WriteLine("\r\nIPv6Any: " + IPAddress.IPv6Any.ToString());

          // Display the server loopback address.
          Console.WriteLine("IPv6Loopback: " + IPAddress.IPv6Loopback.ToString());

          // Used during autoconfiguration first phase.
          Console.WriteLine("IPv6None: " + IPAddress.IPv6None.ToString());

          Console.WriteLine("IsLoopback(IPv6Loopback): " + IPAddress.IsLoopback(IPAddress.IPv6Loopback));
        }
        Console.WriteLine("IsLoopback(Loopback): " + IPAddress.IsLoopback(IPAddress.Loopback));
      }
      catch (Exception e)
      {
        Console.WriteLine("[IPAddresses] Exception: " + e.ToString());
      }
    }

    public static void Main(string[] args)
    {
      string server = null;

      // Define a regular expression to parse user's input.
      // This is a security check. It allows only
      // alphanumeric input string between 2 to 40 character long.
      Regex rex = new Regex(@"^[a-zA-Z]\w{1,39}$");

      if (args.Length < 1)
      {
        // If no server name is passed as an argument to this program, use the current
        // server name as default.
        server = Dns.GetHostName();
        Console.WriteLine("Using current host: " + server);
      }
      else
      {
        server = args[0];
        if (!(rex.Match(server)).Success)
        {
          Console.WriteLine("Input string format not allowed.");
          return;
        }
      }

      // Get the list of the addresses associated with the requested server.
      IPAddresses(server);

      // Get additional address information.
      IPAddressAdditionalInfo();
    }
  }
}

' This program shows how to use the IPAddress class to obtain a server 
' IP addressess and related information.
Imports System.Net
Imports System.Net.Sockets
Imports System.Text.RegularExpressions

Namespace Mssc.Services.ConnectionManagement
  Module M_TestIPAddress

    Class TestIPAddress

      'The IPAddresses method obtains the selected server IP address information.
      'It then displays the type of address family supported by the server and 
      'its IP address in standard and byte format.
      Private Shared Sub IPAddresses(ByVal server As String)
        Try
          Dim ASCII As New System.Text.ASCIIEncoding()

          ' Get server related information.
          Dim heserver As IPHostEntry = Dns.Resolve(server)

          ' Loop on the AddressList
          Dim curAdd As IPAddress
          For Each curAdd In heserver.AddressList

            ' Display the type of address family supported by the server. If the
            ' server is IPv6-enabled this value is: InterNetworkV6. If the server
            ' is also IPv4-enabled there will be an additional value of InterNetwork.
            Console.WriteLine(("AddressFamily: " + curAdd.AddressFamily.ToString()))

            ' Display the ScopeId property in case of IPV6 addresses.
            If curAdd.AddressFamily.ToString() = ProtocolFamily.InterNetworkV6.ToString() Then
              Console.WriteLine(("Scope Id: " + curAdd.ScopeId.ToString()))
            End If

            ' Display the server IP address in the standard format. In 
            ' IPv4 the format will be dotted-quad notation, in IPv6 it will be
            ' in in colon-hexadecimal notation.
            Console.WriteLine(("Address: " + curAdd.ToString()))

            ' Display the server IP address in byte format.
            Console.Write("AddressBytes: ")



            Dim bytes As [Byte]() = curAdd.GetAddressBytes()
            Dim i As Integer
            For i = 0 To bytes.Length - 1
              Console.Write(bytes(i))
            Next i
            Console.WriteLine(ControlChars.Cr + ControlChars.Lf)
          Next curAdd 

        Catch e As Exception
          Console.WriteLine(("[DoResolve] Exception: " + e.ToString()))
        End Try
      End Sub


      ' This IPAddressAdditionalInfo displays additional server address information.
      Private Shared Sub IPAddressAdditionalInfo()
        Try
          ' Display the flags that show if the server supports IPv4 or IPv6
          ' address schemas.
          Console.WriteLine((ControlChars.Cr + ControlChars.Lf + "SupportsIPv4: " + Socket.SupportsIPv4.ToString()))
          Console.WriteLine(("SupportsIPv6: " + Socket.SupportsIPv6.ToString()))

          If Socket.SupportsIPv6 Then
            ' Display the server Any address. This IP address indicates that the server 
            ' should listen for client activity on all network interfaces. 
            Console.WriteLine((ControlChars.Cr + ControlChars.Lf + "IPv6Any: " + IPAddress.IPv6Any.ToString()))

            ' Display the server loopback address. 
            Console.WriteLine(("IPv6Loopback: " + IPAddress.IPv6Loopback.ToString()))

            ' Used during autoconfiguration first phase.
            Console.WriteLine(("IPv6None: " + IPAddress.IPv6None.ToString()))

            Console.WriteLine(("IsLoopback(IPv6Loopback): " + IPAddress.IsLoopback(IPAddress.IPv6Loopback).ToString()))
          End If
          Console.WriteLine(("IsLoopback(Loopback): " + IPAddress.IsLoopback(IPAddress.Loopback).ToString()))
        Catch e As Exception
          Console.WriteLine(("[IPAddresses] Exception: " + e.ToString()))
        End Try
      End Sub

      Public Shared Sub Main(ByVal args() As String)
        Dim server As String = Nothing

        ' Define a regular expression to parse user's input.
        ' This is a security check. It allows only
        ' alphanumeric input string between 2 to 40 character long.
        Dim rex As New Regex("^[a-zA-Z]\w{1,39}$")

        If args.Length < 1 Then
          ' If no server name is passed as an argument to this program, use the current 
          ' server name as default.
          server = Dns.GetHostName()
          Console.WriteLine(("Using current host: " + server))
        Else
          server = args(0)
          If Not rex.Match(server).Success Then
            Console.WriteLine("Input string format not allowed.")
            Return
          End If
        End If

        ' Get the list of the addresses associated with the requested server.
        IPAddresses(server)

        ' Get additional address information.
        IPAddressAdditionalInfo()
      End Sub
    End Class
  End Module
End Namespace

Megjegyzések

Az IPAddress osztály egy IP-hálózaton lévő számítógép címét tartalmazza.

Konstruktorok

Name	Description
IPAddress(Byte[], Int64)	Inicializálja az IPAddress osztály új példányát a tömbként Byte megadott címmel és a megadott hatókör-azonosítóval.
IPAddress(Byte[])	Inicializálja az IPAddress osztály új példányát a tömbként Byte megadott címmel.
IPAddress(Int64)	Inicializálja az IPAddress osztály új példányát a megadott Int64címmel.
IPAddress(ReadOnlySpan<Byte>, Int64)	Inicializálja az IPAddress osztály új példányát a bájttartományként megadott címmel és a megadott hatókör-azonosítóval.
IPAddress(ReadOnlySpan<Byte>)	Inicializálja az IPAddress osztály új példányát a bájttartományként megadott címmel.

Mezők

Name	Description
Any	Egy IP-címet biztosít, amely azt jelzi, hogy a kiszolgálónak figyelnie kell az ügyféltevékenységeket az összes hálózati adapteren. Ez a mező csak olvasható.
Broadcast	Megadja az IP-címközvetítési címet. Ez a mező csak olvasható.
IPv6Any	A Bind(EndPoint) metódus a IPv6Any mező használatával jelzi, hogy minden Socket hálózati adapteren figyelnie kell az ügyféltevékenységet.
IPv6Loopback	Megadja az IP-visszacsatolási címet. Ez a tulajdonság írásvédett.
IPv6None	Olyan IP-címet biztosít, amely azt jelzi, hogy nem szabad hálózati adaptert használni. Ez a tulajdonság írásvédett.
Loopback	Megadja az IP-visszacsatolási címet. Ez a mező csak olvasható.
None	Olyan IP-címet biztosít, amely azt jelzi, hogy nem szabad hálózati adaptert használni. Ez a mező csak olvasható.

Tulajdonságok

Name	Description
Address	Elavult. Elavult. Elavult. Elavult. Elavult. Ip-cím.
AddressFamily	Lekéri az IP-cím címcsaládját.
IsIPv4MappedToIPv6	Lekérdezi, hogy az IP-cím egy IPv4-megfeleltetett IPv6-cím-e.
IsIPv6LinkLocal	Lekérdezi, hogy a cím egy IPv6-hivatkozás helyi címe-e.
IsIPv6Multicast	Lekérdezi, hogy a cím egy IPv6 csoportos küldésű globális cím-e.
IsIPv6SiteLocal	Lekérdezi, hogy a cím egy IPv6-hely helyi címe-e.
IsIPv6Teredo	Lekérdezi, hogy a cím IPv6 Teredo-cím-e.
IsIPv6UniqueLocal	Lekérdezi, hogy a cím egy egyedi IPv6-cím-e.
ScopeId	Lekéri vagy beállítja az IPv6-címtartomány azonosítót.

Metódusok

Name	Description
Equals(Object)	Két IP-címet hasonlít össze.
GetAddressBytes()	A bájtok tömbjének IPAddress másolatát adja meg hálózati sorrendben.
GetHashCode()	Egy IP-cím kivonatértékét adja vissza.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
HostToNetworkOrder(Int16)	Rövid értéket konvertál a gazdagép bájtsorrendéből hálózati bájtsorrendté.
HostToNetworkOrder(Int32)	Egy egész szám értékét gazda bájtsorrendből hálózati bájtsorrendté alakítja át.
HostToNetworkOrder(Int64)	A gazdagép bájtsorrendje hosszú értéket hálózati bájtsorrendté alakít át.
IsLoopback(IPAddress)	Azt jelzi, hogy a megadott IP-cím-e a visszacsatolási cím.
IsValid(ReadOnlySpan<Char>)	Meghatározza, hogy a megadott időtartam érvényes-e IPAddress.
IsValidUtf8(ReadOnlySpan<Byte>)	Meghatározza, hogy a megadott időtartam érvényes-e IPAddress.
MapToIPv4()	IPAddress Az objektumot egy IPv4-címre képezi le.
MapToIPv6()	IPAddress Az objektumot egy IPv6-címre képezi le.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
NetworkToHostOrder(Int16)	Rövid értéket alakít át hálózati bájtsorrendből gazdagép bájtsorrendté.
NetworkToHostOrder(Int32)	Egy egész szám értékét hálózati bájtsorrendből gazdagép bájtsorrendté alakítja át.
NetworkToHostOrder(Int64)	Hosszú értéket alakít át hálózati bájtsorrendből gazdagép bájtsorrendté.
Parse(ReadOnlySpan<Byte>)	UTF-8 karakterből álló tartományt elemez egy értékben.
Parse(ReadOnlySpan<Char>)	A karaktertartományként ábrázolt IP-címet példánysá IPAddress alakítja.
Parse(String)	Egy IP-cím sztringet konvertál példánysá IPAddress .
ToString()	Egy internetcímet szabványos jelöléssé alakít át.
TryFormat(Span<Byte>, Int32)	Megpróbálja formázni az aktuális IP-címet a megadott tartományba.
TryFormat(Span<Char>, Int32)	Megpróbálja formázni az aktuális IP-címet a megadott tartományba.
TryParse(ReadOnlySpan<Byte>, IPAddress)	Egy UTF-8 karakterből álló pántot próbál elemezni egy értékben.
TryParse(ReadOnlySpan<Char>, IPAddress)	Egy karaktertartományt próbál elemezni egy értékben.
TryParse(String, IPAddress)	Meghatározza, hogy egy sztring érvényes IP-cím-e.
TryWriteBytes(Span<Byte>, Int32)	Megpróbálja az aktuális IP-címet hálózati sorrendben bájtok közé írni.

Explicit interfész-implementációk

Name	Description
IFormattable.ToString(String, IFormatProvider)	Formázza az aktuális példány értékét a megadott formátummal.
IParsable<IPAddress>.Parse(String, IFormatProvider)	Egy sztringet egy értékbe elemez.
IParsable<IPAddress>.TryParse(String, IFormatProvider, IPAddress)	Sztringet próbál elemezni egy IPAddress.
ISpanFormattable.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Megpróbálja formázni az aktuális példány értékét a megadott karaktertartományba.
ISpanParsable<IPAddress>.Parse(ReadOnlySpan<Char>, IFormatProvider)	Több karakterből álló elemet elemez egy értékben.
ISpanParsable<IPAddress>.TryParse(ReadOnlySpan<Char>, IFormatProvider, IPAddress)	Egy karaktertartományt próbál elemezni egy értékben.
IUtf8SpanFormattable.TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Az aktuális példány értékét UTF-8 formátumban próbálja formázni a megadott bájttartományba.
IUtf8SpanParsable<IPAddress>.Parse(ReadOnlySpan<Byte>, IFormatProvider)	UTF-8 karakterből álló tartományt elemez egy értékben.
IUtf8SpanParsable<IPAddress>.TryParse(ReadOnlySpan<Byte>, IFormatProvider, IPAddress)	Ip-címet biztosít.

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?