SqlString Struktura

Definicja

Reprezentuje strumień o zmiennej długości znaków, który ma być przechowywany lub pobrany z bazy danych.Represents a variable-length stream of characters to be stored in or retrieved from the database. SqlString ma inną źródłową strukturę danych z odpowiednich .NET Framework String typu danych.SqlString has a different underlying data structure from its corresponding .NET Framework String data type.

public value class SqlString : IComparable, System::Data::SqlTypes::INullable, System::Xml::Serialization::IXmlSerializable
[System.Serializable]
public struct SqlString : IComparable, System.Data.SqlTypes.INullable, System.Xml.Serialization.IXmlSerializable
type SqlString = struct
    interface INullable
    interface IXmlSerializable
Public Structure SqlString
Implements IComparable, INullable, IXmlSerializable
Dziedziczenie
SqlString
Atrybuty
Implementuje

Uwagi

String zawsze używa domyślnej CultureInfo z bieżącego wątku, ale SqlString zawiera własny identyfikator ustawień regionalnych i porównaj flagi.String always uses the default CultureInfo from the current thread, but SqlString contains its own locale Id and compare flags. Wynik porównania dwóch struktur SqlString jest niezależny od systemu operacyjnego i bieżących ustawień regionalnych wątku.The comparison result of two SqlString structures is independent of operating system and current thread locale.

W przypadku użycia operatorów porównania SqlString, należy pamiętać, że jeśli identyfikatory LCID argumentów są różne, funkcja porównania zgłosi wyjątek, ponieważ nie można ich porównać.When you use SqlString comparison operators, note that if the LCIDs of arguments are different, comparison functions throw an exception because they cannot be compared. Na przykład, instrukcjaFor example, the statement

SqlString mySqlString = new SqlString("abc");  

jest równoważnyis equivalent to

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

Konstruktory

SqlString(Int32, SqlCompareOptions, Byte[])

Inicjuje nowe wystąpienie struktury SqlString przy użyciu określonego identyfikatora ustawień regionalnych, opcji porównania i danych.Initializes a new instance of the SqlString structure using the specified locale id, compare options, and data.

SqlString(Int32, SqlCompareOptions, Byte[], Boolean)

Inicjuje nowe wystąpienie klasy SqlString klasy.Initializes a new instance of the SqlString class.

SqlString(Int32, SqlCompareOptions, Byte[], Int32, Int32)

Inicjuje nowe wystąpienie klasy SqlString klasy.Initializes a new instance of the SqlString class.

SqlString(Int32, SqlCompareOptions, Byte[], Int32, Int32, Boolean)

Inicjuje nowe wystąpienie klasy SqlString klasy.Initializes a new instance of the SqlString class.

SqlString(String)

Inicjuje nowe wystąpienie struktury SqlString przy użyciu określonego ciągu.Initializes a new instance of the SqlString structure using the specified string.

SqlString(String, Int32)

Inicjuje nowe wystąpienie struktury SqlString przy użyciu określonych wartości identyfikatorów dla ciągów i ustawień regionalnych.Initializes a new instance of the SqlString structure using the specified string and locale id values.

SqlString(String, Int32, SqlCompareOptions)

Inicjuje nowe wystąpienie struktury SqlString przy użyciu określonego ciągu, identyfikatora ustawień regionalnych i wartości opcji porównywania.Initializes a new instance of the SqlString structure using the specified string, locale id, and compare option values.

Pola

BinarySort

Określa, że sortowania powinny być oparte na liczbie znaków, a nie w wartości alfabetycznej.Specifies that sorts should be based on a characters numeric value instead of its alphabetical value.

BinarySort2

Określa, że sortowania powinny być oparte na wartości liczbowej znaku zamiast jego wartości alfabetycznej.Specifies that sorts should be based on a character's numeric value instead of its alphabetical value.

IgnoreCase

Określa, że porównania SqlString powinny ignorować wielkość liter.Specifies that SqlString comparisons should ignore case.

IgnoreKanaType

Określa, że porównanie ciągów musi ignorować typ kana.Specifies that the string comparison must ignore the Kana type.

IgnoreNonSpace

Określa, że porównanie ciągów musi ignorować znaki nienależące do łączenia, takie jak znaki diakrytyczne.Specifies that the string comparison must ignore non-space combining characters, such as diacritics.

IgnoreWidth

Określa, że porównanie ciągów musi ignorować szerokość znaków.Specifies that the string comparison must ignore the character width.

Null

Reprezentuje DBNull, które można przypisać do tego wystąpienia struktury SqlString.Represents a DBNull that can be assigned to this instance of the SqlString structure.

Właściwości

CompareInfo

Pobiera obiekt CompareInfo, który definiuje, jak należy wykonać porównania ciągów dla tej struktury SqlString.Gets the CompareInfo object that defines how string comparisons should be performed for this SqlString structure.

CultureInfo

Pobiera strukturę CultureInfo, która reprezentuje informacje o kulturze tego obiektu SqlString.Gets the CultureInfo structure that represents information about the culture of this SqlString object.

IsNull

Wskazuje, czy ta struktura SqlString ma wartość null.Indicates whether this SqlString structure is null.

LCID

Określa geograficzne ustawienia regionalne i język dla struktury SqlString.Specifies the geographical locale and language for the SqlString structure.

SqlCompareOptions

Kombinacja co najmniej jednej SqlCompareOptions wartości wyliczenia, która reprezentuje sposób, w jaki ten SqlString powinien być porównywany z innymi strukturami SqlString.A combination of one or more of the SqlCompareOptions enumeration values that represent the way in which this SqlString should be compared to other SqlString structures.

Value

Pobiera ciąg, który jest przechowywany w tej strukturze SqlString.Gets the string that is stored in this SqlString structure. Ta właściwość jest tylko do odczytu.This property is read-only.

Metody

Add(SqlString, SqlString)

Łączy dwie określone wartości SqlString, aby utworzyć nową strukturę SqlString.Concatenates two specified SqlString values to create a new SqlString structure.

Clone()

Tworzy kopię tego obiektu SqlString.Creates a copy of this SqlString object.

CompareOptionsFromSqlCompareOptions(SqlCompareOptions)

Pobiera odpowiednik wyliczenia CompareOptions określonej wartości SqlCompareOptions.Gets the CompareOptions enumeration equivalent of the specified SqlCompareOptions value.

CompareTo(Object)

Porównuje ten obiekt SqlString z podaną Object i zwraca wskazanie ich względnych wartości.Compares this SqlString object to the supplied Object and returns an indication of their relative values.

CompareTo(SqlString)

Porównuje to wystąpienie SqlString z podaną SqlString i zwraca wskazanie ich względnych wartości.Compares this SqlString instance to the supplied SqlString and returns an indication of their relative values.

Concat(SqlString, SqlString)

Łączy dwie określone struktury SqlString.Concatenates the two specified SqlString structures.

Equals(Object)

Porównuje podany parametr obiektu z właściwością Value obiektu SqlString.Compares the supplied object parameter to the Value property of the SqlString object.

Equals(SqlString, SqlString)

Wykonuje porównanie logiczne dwóch operandów SqlString, aby określić, czy są równe.Performs a logical comparison of the two SqlString operands to determine whether they are equal.

GetHashCode()

Pobiera wartość skrótu dla tego wystąpienia.Gets the hash code for this instance.

GetNonUnicodeBytes()

Pobiera tablicę bajtów, która zawiera zawartość SqlString w formacie ANSI.Gets an array of bytes, that contains the contents of the SqlString in ANSI format.

GetUnicodeBytes()

Pobiera tablicę bajtów, która zawiera zawartość SqlString w formacie Unicode.Gets an array of bytes, that contains the contents of the SqlString in Unicode format.

GetXsdType(XmlSchemaSet)

Zwraca język definicji schematu XML (XSD) określonego XmlSchemaSet.Returns the XML Schema definition language (XSD) of the specified XmlSchemaSet.

GreaterThan(SqlString, SqlString)

Wykonuje porównanie logiczne dwóch operandów SqlString, aby określić, czy pierwsze jest większe niż sekunda.Performs a logical comparison of the two SqlString operands to determine whether the first is greater than the second.

GreaterThanOrEqual(SqlString, SqlString)

Wykonuje porównanie logiczne dwóch operandów SqlString, aby określić, czy pierwsze jest większe lub równe sekundzie.Performs a logical comparison of the two SqlString operands to determine whether the first is greater than or equal to the second.

LessThan(SqlString, SqlString)

Wykonuje porównanie logiczne dwóch operandów SqlString, aby określić, czy pierwsze jest mniejsze niż sekunda.Performs a logical comparison of the two SqlString operands to determine whether the first is less than the second.

LessThanOrEqual(SqlString, SqlString)

Wykonuje porównanie logiczne dwóch operandów SqlString, aby określić, czy pierwsze jest mniejsze niż lub równe drugiemu.Performs a logical comparison of the two SqlString operands to determine whether the first is less than or equal to the second.

NotEquals(SqlString, SqlString)

Wykonuje porównanie logiczne dwóch operandów SqlString, aby określić, czy nie są równe.Performs a logical comparison of the two SqlString operands to determine whether they are not equal.

ToSqlBoolean()

Konwertuje tę strukturę SqlString na SqlBoolean.Converts this SqlString structure to SqlBoolean.

ToSqlByte()

Konwertuje tę strukturę SqlString na SqlByte.Converts this SqlString structure to SqlByte.

ToSqlDateTime()

Konwertuje tę strukturę SqlString na SqlDateTime.Converts this SqlString structure to SqlDateTime.

ToSqlDecimal()

Konwertuje tę strukturę SqlString na SqlDecimal.Converts this SqlString structure to SqlDecimal.

ToSqlDouble()

Konwertuje tę strukturę SqlString na SqlDouble.Converts this SqlString structure to SqlDouble.

ToSqlGuid()

Konwertuje tę strukturę SqlString na SqlGuid.Converts this SqlString structure to SqlGuid.

ToSqlInt16()

Konwertuje tę strukturę SqlString na SqlInt16.Converts this SqlString structure to SqlInt16.

ToSqlInt32()

Konwertuje tę strukturę SqlString na SqlInt32.Converts this SqlString structure to SqlInt32.

ToSqlInt64()

Konwertuje tę strukturę SqlString na SqlInt64.Converts this SqlString structure to SqlInt64.

ToSqlMoney()

Konwertuje tę strukturę SqlString na SqlMoney.Converts this SqlString structure to SqlMoney.

ToSqlSingle()

Konwertuje tę strukturę SqlString na SqlSingle.Converts this SqlString structure to SqlSingle.

ToString()

Konwertuje obiekt SqlString na String.Converts a SqlString object to a String.

Operatory

Addition(SqlString, SqlString)

Łączy dwie określone struktury SqlString.Concatenates the two specified SqlString structures.

Equality(SqlString, SqlString)

Wykonuje porównanie logiczne dwóch operandów SqlString, aby określić, czy są równe.Performs a logical comparison of the two SqlString operands to determine whether they are equal.

Explicit(SqlBoolean to SqlString)

Konwertuje określoną strukturę SqlBoolean na SqlString.Converts the specified SqlBoolean structure to SqlString.

Explicit(SqlByte to SqlString)

Konwertuje określoną strukturę SqlByte na SqlString.Converts the specified SqlByte structure to SqlString.

Explicit(SqlDateTime to SqlString)

Konwertuje określony SqlDateTime parametr na SqlString.Converts the specified SqlDateTime parameter to SqlString.

Explicit(SqlDecimal to SqlString)

Konwertuje określony SqlDecimal parametr na SqlString.Converts the specified SqlDecimal parameter to SqlString.

Explicit(SqlDouble to SqlString)

Konwertuje określony SqlDouble parametr na SqlString.Converts the specified SqlDouble parameter to SqlString.

Explicit(SqlGuid to SqlString)

Konwertuje określony SqlGuid parametr na SqlString.Converts the specified SqlGuid parameter to SqlString.

Explicit(SqlInt16 to SqlString)

Konwertuje określony SqlInt16 parametr na SqlString.Converts the specified SqlInt16 parameter to SqlString.

Explicit(SqlInt32 to SqlString)

Konwertuje określony SqlInt32 parametr na SqlString.Converts the specified SqlInt32 parameter to SqlString.

Explicit(SqlInt64 to SqlString)

Konwertuje określony SqlInt64 parametr na SqlString.Converts the specified SqlInt64 parameter to SqlString.

Explicit(SqlMoney to SqlString)

Konwertuje określony SqlMoney parametr na SqlString.Converts the specified SqlMoney parameter to SqlString.

Explicit(SqlSingle to SqlString)

Konwertuje określony SqlSingle parametr na SqlString.Converts the specified SqlSingle parameter to SqlString.

Explicit(SqlString to String)

Konwertuje SqlString na StringConverts a SqlString to a String

GreaterThan(SqlString, SqlString)

Wykonuje porównanie logiczne dwóch operandów SqlString, aby określić, czy pierwsze jest większe niż sekunda.Performs a logical comparison of the two SqlString operands to determine whether the first is greater than the second.

GreaterThanOrEqual(SqlString, SqlString)

Wykonuje porównanie logiczne dwóch operandów SqlString, aby określić, czy pierwsze jest większe lub równe sekundzie.Performs a logical comparison of the two SqlString operands to determine whether the first is greater than or equal to the second.

Implicit(String to SqlString)

Konwertuje parametr String na SqlString.Converts the String parameter to a SqlString.

Inequality(SqlString, SqlString)

Wykonuje porównanie logiczne dwóch operandów SqlString, aby określić, czy nie są równe.Performs a logical comparison of the two SqlString operands to determine whether they are not equal.

LessThan(SqlString, SqlString)

Wykonuje porównanie logiczne dwóch operandów SqlString, aby określić, czy pierwsze jest mniejsze niż sekunda.Performs a logical comparison of the two SqlString operands to determine whether the first is less than the second.

LessThanOrEqual(SqlString, SqlString)

Wykonuje porównanie logiczne dwóch operandów SqlString, aby określić, czy pierwsze jest mniejsze niż lub równe drugiemu.Performs a logical comparison of the two SqlString operands to determine whether the first is less than or equal to the second.

Jawne implementacje interfejsu

IXmlSerializable.GetSchema()

Ten element członkowski obsługuje infrastrukturę programu .NET Framework i nie jest przeznaczony do użycia bezpośrednio w kodzie.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

IXmlSerializable.ReadXml(XmlReader)

Ten element członkowski obsługuje infrastrukturę programu .NET Framework i nie jest przeznaczony do użycia bezpośrednio w kodzie.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

IXmlSerializable.WriteXml(XmlWriter)

Ten element członkowski obsługuje infrastrukturę programu .NET Framework i nie jest przeznaczony do użycia bezpośrednio w kodzie.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Dotyczy

Zobacz też