IPAddress Construtores

Definição

Namespace:

System.Net

Assemblies:

netstandard.dll, System.Net.Primitives.dll

Inicializa uma nova instância da classe IPAddress.

Sobrecargas

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

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 incorreto.

Comentários

O IPAddress valor é criado com a Address propriedade definida como address.

Se o comprimento for address 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 em 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 IPAddress classe 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 como newAddress.

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

IPAddress(ReadOnlySpan<Byte>)

Origem:

IPAddress.cs

Inicializa uma nova instância da IPAddress classe 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 primeiro byte mais significativo na posição 0 do índice.

Exceções

ArgumentException

address contém um endereço IP incorreto.

Comentários

O IPAddress valor é criado com a Address propriedade definida como address.

Se o comprimento for address 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 IPAddress classe com o endereço especificado como uma Byte matriz 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 incorreto.

ArgumentOutOfRangeException

scopeid < 0 ou

scopeid > 0x00000000ffffffff

Comentários

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

Supõe-se Byte que a matriz esteja em 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 IPAddress classe 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 de 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 incorreto.

ArgumentOutOfRangeException

scopeid < 0

- ou -

scopeid > 0x00000000ffffffff

Comentários

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

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