SqlString Estrutura

Definição

Namespace:

System.Data.SqlTypes

Assembly:

System.Data.Common.dll

Origem:

SQLString.cs

Representa um fluxo de tamanho variável de caracteres a ser armazenado ou recuperado do banco de dados. SqlString tem uma estrutura de dados subjacente diferente de seu correspondente do tipo de dados String do .NET.

public value class SqlString : IComparable, IEquatable<System::Data::SqlTypes::SqlString>, System::Data::SqlTypes::INullable, System::Xml::Serialization::IXmlSerializable

public struct SqlString : IComparable, IEquatable<System.Data.SqlTypes.SqlString>, System.Data.SqlTypes.INullable, System.Xml.Serialization.IXmlSerializable

type SqlString = struct
    interface INullable
    interface IXmlSerializable

Public Structure SqlString
Implements IComparable, IEquatable(Of SqlString), INullable, IXmlSerializable

Herança

Object

ValueType

SqlString

Implementações

INullable IComparable IXmlSerializable IEquatable<SqlString>

Comentários

String sempre usa o padrão CultureInfo do thread atual, mas SqlString contém sua própria ID de localidade e compara sinalizadores. O resultado da comparação de duas SqlString estruturas é independente do sistema operacional e da localidade atual do thread.

Quando você usa SqlString operadores de comparação, observe que, se os LCIDs dos argumentos forem diferentes, as funções de comparação gerarão uma exceção porque não poderão ser comparadas. Por exemplo, a instrução

SqlString mySqlString = new SqlString("abc");  

é equivalente a

SqlString mySqlString = new SqlString("abc", CultureInfo.CurrentCulture.LCID);  

Construtores

SqlString(Int32, SqlCompareOptions, Byte[])	Inicializa uma nova instância da estrutura SqlString usando a identificação de localidade, as opções de comparação e os dados especificados.
SqlString(Int32, SqlCompareOptions, Byte[], Boolean)	Inicializa uma nova instância da classe SqlString.
SqlString(Int32, SqlCompareOptions, Byte[], Int32, Int32)	Inicializa uma nova instância da classe SqlString.
SqlString(Int32, SqlCompareOptions, Byte[], Int32, Int32, Boolean)	Inicializa uma nova instância da classe SqlString.
SqlString(String)	Inicializa uma nova instância da estrutura SqlString usando a cadeia de caracteres especificada.
SqlString(String, Int32)	Inicializa uma nova instância da estrutura SqlString usando os valores de cadeia de caracteres e de identificação de localidade especificados.
SqlString(String, Int32, SqlCompareOptions)	Inicializa uma nova instância da estrutura SqlString usando os valores de cadeia de caracteres, identificação de localidade e opções de comparação especificados.

Campos

BinarySort	Especifica que as classificações devem ser baseadas em um valor numérico de caracteres em vez de seu valor alfabético.
BinarySort2	Especifica que as classificações devem ser baseadas em um valor numérico de caracteres em vez de seu valor alfabético.
IgnoreCase	Especifica que comparações SqlString devem ignorar maiúsculas e minúsculas.
IgnoreKanaType	Especifica que se a comparação de cadeia de caracteres deve ignorar o tipo Kana.
IgnoreNonSpace	Especifica que a comparação de cadeia de caracteres deve ignorar caracteres sem espaçamento, como sinais diacríticos.
IgnoreWidth	Especifica que a comparação de cadeia de caracteres deve ignorar a largura do caractere.
Null	Representa um DBNull que pode ser atribuído a essa instância da estrutura SqlString.

Propriedades

CompareInfo	Obtém o objeto CompareInfo que define como as comparações de cadeia de caracteres devem ser realizadas nesta estrutura SqlString.
CultureInfo	Obtém a estrutura CultureInfo que representa informações sobre a cultura deste objeto SqlString.
IsNull	Indica se esta estrutura SqlString é nula.
LCID	Especifica a localidade geográfica e o idioma para a estrutura SqlString.
SqlCompareOptions	Uma combinação de um ou mais valores de enumeração SqlCompareOptions que representam o modo no qual o SqlString deve ser comparados às outras estruturas SqlString.
Value	Obtém a cadeia de caracteres armazenada nesta estrutura SqlString. Esta propriedade é somente para leitura.

Métodos

Add(SqlString, SqlString)	Concatena dois valores SqlString especificados para criar uma nova estrutura SqlString.
Clone()	Cria uma cópia deste objeto SqlString.
CompareOptionsFromSqlCompareOptions(SqlCompareOptions)	Obtém a enumeração CompareOptions equivalente do valor SqlCompareOptions especificado.
CompareTo(Object)	Compara este objeto SqlString com o Object fornecido e retorna uma indicação de seus valores relativos.
CompareTo(SqlString)	Compara esta instância SqlString com o SqlString fornecido e retorna uma indicação de seus valores relativos.
Concat(SqlString, SqlString)	Concatena as duas estruturas SqlString especificadas.
Equals(Object)	Compara o parâmetro de objeto fornecido com a propriedade Value do objeto SqlString.
Equals(SqlString)	Indica se a instância atual é igual a outra instância do mesmo tipo.
Equals(SqlString, SqlString)	Executa uma comparação lógica dos dois operandos SqlString para determinar se eles são iguais.
GetHashCode()	Obtém o código hash para esta instância.
GetNonUnicodeBytes()	Obtém uma matriz de bytes que tem o conteúdo do SqlString no formato ANSI.
GetUnicodeBytes()	Obtém uma matriz de bytes que tem o conteúdo do SqlString no formato Unicode.
GetXsdType(XmlSchemaSet)	Retorna a XSD (linguagem de definição de esquema XML) do XmlSchemaSet especificado.
GreaterThan(SqlString, SqlString)	Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é maior que o segundo.
GreaterThanOrEqual(SqlString, SqlString)	Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é maior ou igual ao segundo.
LessThan(SqlString, SqlString)	Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é menor que o segundo.
LessThanOrEqual(SqlString, SqlString)	Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é menor ou igual ao segundo.
NotEquals(SqlString, SqlString)	Executa uma comparação lógica dos dois operandos SqlString para determinar se eles são diferentes.
ToSqlBoolean()	Converte esta estrutura SqlString em SqlBoolean.
ToSqlByte()	Converte esta estrutura SqlString em SqlByte.
ToSqlDateTime()	Converte esta estrutura SqlString em SqlDateTime.
ToSqlDecimal()	Converte esta estrutura SqlString em SqlDecimal.
ToSqlDouble()	Converte esta estrutura SqlString em SqlDouble.
ToSqlGuid()	Converte esta estrutura SqlString em SqlGuid.
ToSqlInt16()	Converte esta estrutura SqlString em SqlInt16.
ToSqlInt32()	Converte esta estrutura SqlString em SqlInt32.
ToSqlInt64()	Converte esta estrutura SqlString em SqlInt64.
ToSqlMoney()	Converte esta estrutura SqlString em SqlMoney.
ToSqlSingle()	Converte esta estrutura SqlString em SqlSingle.
ToString()	Converte um objeto SqlString em um String.

Operadores

Addition(SqlString, SqlString)	Concatena as duas estruturas SqlString especificadas.
Equality(SqlString, SqlString)	Executa uma comparação lógica dos dois operandos SqlString para determinar se eles são iguais.
Explicit(SqlBoolean to SqlString)	Converte a estrutura SqlBoolean especificada em SqlString.
Explicit(SqlByte to SqlString)	Converte a estrutura SqlByte especificada em SqlString.
Explicit(SqlDateTime to SqlString)	Converte o parâmetro especificado SqlDateTime em SqlString.
Explicit(SqlDecimal to SqlString)	Converte o parâmetro especificado SqlDecimal em SqlString.
Explicit(SqlDouble to SqlString)	Converte o parâmetro especificado SqlDouble em SqlString.
Explicit(SqlGuid to SqlString)	Converte o parâmetro especificado SqlGuid em SqlString.
Explicit(SqlInt16 to SqlString)	Converte o parâmetro especificado SqlInt16 em SqlString.
Explicit(SqlInt32 to SqlString)	Converte o parâmetro especificado SqlInt32 em SqlString.
Explicit(SqlInt64 to SqlString)	Converte o parâmetro especificado SqlInt64 em SqlString.
Explicit(SqlMoney to SqlString)	Converte o parâmetro especificado SqlMoney em SqlString.
Explicit(SqlSingle to SqlString)	Converte o parâmetro especificado SqlSingle em SqlString.
Explicit(SqlString to String)	Converte uma SqlString em uma String.
GreaterThan(SqlString, SqlString)	Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é maior que o segundo.
GreaterThanOrEqual(SqlString, SqlString)	Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é maior ou igual ao segundo.
Implicit(String to SqlString)	Converte o parâmetro String em um SqlString.
Inequality(SqlString, SqlString)	Executa uma comparação lógica dos dois operandos SqlString para determinar se eles são diferentes.
LessThan(SqlString, SqlString)	Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é menor que o segundo.
LessThanOrEqual(SqlString, SqlString)	Executa uma comparação lógica dos dois operandos SqlString para determinar se o primeiro é menor ou igual ao segundo.

Implantações explícitas de interface

IXmlSerializable.GetSchema()	Esse membro oferece suporte à infraestrutura .NET Framework e não se destina à utilização diretamente no seu código.
IXmlSerializable.ReadXml(XmlReader)	Esse membro oferece suporte à infraestrutura .NET Framework e não se destina à utilização diretamente no seu código.
IXmlSerializable.WriteXml(XmlWriter)	Esse membro oferece suporte à infraestrutura .NET Framework e não se destina à utilização diretamente no seu código.

Confira também

• CurrentCulture
• Tipos de dados do SQL Server e ADO.NET