IPAddress Construtores

Definição

Espaço de Nomes:: System.Net

Assemblagens:: System.dll, System.Net.Primitives.dll

Assemblagem:: System.dll

Assemblagem:: System.Net.Primitives.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da IPAddress classe.

Sobrecargas

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

IPAddress(Byte[])

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

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 do array de bytes do endereço IP.

Exceções

ArgumentNullException

address é null.

ArgumentException

address contém um endereço IP defeituoso.

Observações

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

Se o comprimento de address for 4, IPAddress(Byte[]) constrói-se um endereço IPv4; caso contrário, constrói-se um endereço IPv6 com escopo de 0.

Assume-se que o Byte array está em ordem de bytes de rede, com o byte mais significativo primeiro na posição de índice 0.

Aplica-se a

IPAddress(Int64)

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 em formato big-endian seria o endereço IP "143.24.20.36".

Exceções

ArgumentOutOfRangeException

newAddress < 0 ou

newAddress > 0x00000000FFFFFFFF

Observações

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

Assume-se que o Int64 valor está por ordem de bytes de rede.

Aplica-se a

IPAddress(ReadOnlySpan<Byte>)

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

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 em bytes do endereço IP, em ordem de bytes de rede, com o byte mais significativo primeiro na posição de índice 0.

Exceções

ArgumentException

address contém um endereço IP defeituoso.

Observações

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

Se o comprimento de address for 4, este método constrói um endereço IPv4; caso contrário, é construído um endereço IPv6 com um âmbito de 0.

Aplica-se a

IPAddress(Byte[], Int64)

Inicializa uma nova instância da IPAddress classe com o endereço especificado como array Byte e o identificador de âmbito 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 do array de bytes do endereço IP.

scopeid: Int64

O valor longo do identificador do âmbito.

Exceções

ArgumentNullException

address é null.

ArgumentException

address contém um endereço IP defeituoso.

ArgumentOutOfRangeException

scopeid < 0 ou

scopeid > 0x00000000FFFFFFFF

Observações

Este construtor instancia um endereço IPv6. Identifica scopeid uma interface de rede no caso de um endereço link-local. O âmbito é válido apenas para endereços link-local e site-local.

Assume-se que o Byte array está em ordem de bytes de rede, com o byte mais significativo primeiro na posição de índice 0.

Aplica-se a

IPAddress(ReadOnlySpan<Byte>, Int64)

Inicializa uma nova instância da IPAddress classe com o endereço especificado como um byte span 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 byte span do endereço IP.

scopeid: Int64

O valor longo do identificador do âmbito.

Exceções

ArgumentException

address contém um endereço IP defeituoso.

ArgumentOutOfRangeException

scopeid < 0

-ou-

scopeid > 0x00000000FFFFFFFF

Observações

Este construtor instancia um endereço IPv6. Identifica scopeid uma interface de rede no caso de um endereço link-local. O âmbito é válido apenas para endereços link-local e site-local.

Assume-se que o byte span está por ordem de bytes de rede, com o byte mais significativo primeiro na posição 0 do índice.

Aplica-se a

Comentários

Esta página foi útil?