IPAddress Construtores

Definição

Namespace:

System.Net

Assembly:

System.Net.Primitives.dll

Inicializa uma nova instância da classe IPAddress.

Sobrecargas

IPAddress(Byte[])	Inicializa uma nova instância da classe IPAddress com o endereço especificado como uma matriz Byte.
IPAddress(Int64)	Inicializa uma nova instância da classe IPAddress com o endereço especificado como um Int64.
IPAddress(ReadOnlySpan<Byte>)	Inicializa uma nova instância da classe IPAddress com o endereço especificado como um intervalo de bytes.
IPAddress(Byte[], Int64)	Inicializa uma nova instância da classe IPAddress com o endereço especificado como uma matriz Byte e o identificador de escopo especificado.
IPAddress(ReadOnlySpan<Byte>, Int64)	Inicializa uma nova instância da classe IPAddress com o endereço especificado como um intervalo de bytes e o identificador de escopo especificado.

IPAddress(Byte[])

Origem:

IPAddress.cs

Inicializa uma nova instância da classe IPAddress com o endereço especificado como uma matriz Byte.

public:
 IPAddress(cli::array <System::Byte> ^ address);

public IPAddress (byte[] address);

new System.Net.IPAddress : byte[] -> System.Net.IPAddress

Public Sub New (address As Byte())

Parâmetros

address

Byte[]

O valor da matriz de bytes do endereço IP.

Exceções

ArgumentNullException

address é null.

ArgumentException

address contém um endereço IP inválido.

Comentários

O IPAddress é criado com a Address propriedade definida addresscomo .

Se o comprimento de address for 4, IPAddress(Byte[]) construirá um endereço IPv4; caso contrário, um endereço IPv6 com um escopo de 0 será construído.

Supõe-se Byte que a matriz esteja na ordem de bytes de rede com o byte mais significativo primeiro na posição 0 do índice.

IPAddress(Int64)

Origem:

IPAddress.cs

Inicializa uma nova instância da classe IPAddress com o endereço especificado como um Int64.

public:
 IPAddress(long newAddress);

public IPAddress (long newAddress);

new System.Net.IPAddress : int64 -> System.Net.IPAddress

Public Sub New (newAddress As Long)

Parâmetros

newAddress

Int64

O valor longo do endereço IP. Por exemplo, o valor 0x2414188f no formato big endian seria o endereço IP "143.24.20.36".

Exceções

ArgumentOutOfRangeException

newAddress < 0 ou

newAddress > 0x00000000FFFFFFFF

Comentários

A IPAddress instância é criada com a Address propriedade definida newAddresscomo .

Supõe-se Int64 que o valor esteja em ordem de byte de rede.

IPAddress(ReadOnlySpan<Byte>)

Origem:

IPAddress.cs

Inicializa uma nova instância da classe IPAddress com o endereço especificado como um intervalo de bytes.

public:
 IPAddress(ReadOnlySpan<System::Byte> address);

public IPAddress (ReadOnlySpan<byte> address);

new System.Net.IPAddress : ReadOnlySpan<byte> -> System.Net.IPAddress

Public Sub New (address As ReadOnlySpan(Of Byte))

Parâmetros

address

ReadOnlySpan<Byte>

A representação de bytes do endereço IP, em ordem de byte de rede, com o byte mais significativo primeiro na posição 0 do índice.

Exceções

ArgumentException

address contém um endereço IP inválido.

Comentários

O IPAddress é criado com a Address propriedade definida addresscomo .

Se o comprimento de address for 4, esse método construirá um endereço IPv4; caso contrário, um endereço IPv6 com um escopo de 0 será construído.

IPAddress(Byte[], Int64)

Origem:

IPAddress.cs

Inicializa uma nova instância da classe IPAddress com o endereço especificado como uma matriz Byte e o identificador de escopo especificado.

public:
 IPAddress(cli::array <System::Byte> ^ address, long scopeid);

public IPAddress (byte[] address, long scopeid);

new System.Net.IPAddress : byte[] * int64 -> System.Net.IPAddress

Public Sub New (address As Byte(), scopeid As Long)

Parâmetros

address

Byte[]

O valor da matriz de bytes do endereço IP.

scopeid

Int64

O valor longo do identificador de escopo.

Exceções

ArgumentNullException

address é null.

ArgumentException

address contém um endereço IP inválido.

ArgumentOutOfRangeException

scopeid < 0 ou

scopeid > 0x00000000FFFFFFFF

Comentários

Esse construtor cria uma instância de um endereço IPv6. O scopeid identifica um adaptador de rede no caso de um endereço local de link. O escopo é válido apenas para endereços locais de link e site.local.

Supõe-se Byte que a matriz esteja na ordem de bytes de rede com o byte mais significativo primeiro na posição 0 do índice.

IPAddress(ReadOnlySpan<Byte>, Int64)

Origem:

IPAddress.cs

Inicializa uma nova instância da classe IPAddress com o endereço especificado como um intervalo de bytes e o identificador de escopo especificado.

public:
 IPAddress(ReadOnlySpan<System::Byte> address, long scopeid);

public IPAddress (ReadOnlySpan<byte> address, long scopeid);

new System.Net.IPAddress : ReadOnlySpan<byte> * int64 -> System.Net.IPAddress

Public Sub New (address As ReadOnlySpan(Of Byte), scopeid As Long)

Parâmetros

address

ReadOnlySpan<Byte>

O valor do intervalo de bytes do endereço IP.

scopeid

Int64

O valor longo do identificador de escopo.

Exceções

ArgumentException

address contém um endereço IP inválido.

ArgumentOutOfRangeException

scopeid < 0

-ou-

scopeid > 0x00000000FFFFFFFF

Comentários

Esse construtor cria uma instância de um endereço IPv6. O scopeid identifica um adaptador de rede no caso de um endereço local de link. O escopo é válido apenas para endereços locais de link e site.local.

Presume-se que o intervalo de bytes esteja na ordem de bytes de rede com o byte mais significativo primeiro na posição 0 do índice.