Strings.StrConv(String, VbStrConv, Int32) Metoda

Definice

Obor názvů:: Microsoft.VisualBasic

Sestavení:: Microsoft.VisualBasic.Core.dll

Sestavení:

Sestavení:: Microsoft.VisualBasic.dll

Vrátí řetězec převedený podle zadání.Returns a string converted as specified.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string? StrConv (string? str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);

public static string StrConv (string str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> string

static member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> string

Public Function StrConv (str As String, Conversion As VbStrConv, Optional LocaleID As Integer = 0) As String

Parametry

str: String

Povinná hodnota.Required. String výraz, který se má převéstString expression to be converted.

Conversion: VbStrConv

Povinná hodnota.Required. VbStrConv člen.VbStrConv member. Hodnota výčtu určující typ převodu, který má být proveden.The enumeration value specifying the type of conversion to perform.

LocaleID: Int32

Nepovinný parametr.Optional. LocaleIDHodnota, pokud se liší od systémové LocaleID hodnoty.The LocaleID value, if different from the system LocaleID value. (Systémová LocaleID hodnota je výchozí.)(The system LocaleID value is the default.)

Návraty

String

Řetězec se převedl na zadaný.A string converted as specified.

Atributy: SupportedOSPlatformAttribute

Výjimky

ArgumentException

Nepodporovaný LocaleID , Conversion < 0 nebo > 2048 nebo nepodporovaný převod pro zadané národní prostředí.Unsupported LocaleID, Conversion < 0 or > 2048, or unsupported conversion for specified locale.

Příklady

Tento příklad převede text na malá písmena.This example converts text into all lowercase letters.

Dim sText As String = "Hello World"
' Returns "hello world".
Dim sNewText As String = StrConv(sText, VbStrConv.LowerCase)

Poznámky

Konstanty,,,, VbStrConv.Wide VbStrConv.Narrow VbStrConv.SimplifiedChinese VbStrConv.TraditionalChinese VbStrConv.Katakana a VbStrConv.Hiragana mohou způsobit chyby za běhu při použití v místních prostředích, kde se nevztahují, ale ne vždy: konstanty VbStrConv.Katakana a VbStrConv.Hiragana lze je použít v nejaponském systému s nainstalovanou japonštinou jazykové sady.The constants VbStrConv.Wide, VbStrConv.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakana, and VbStrConv.Hiragana can cause run-time errors when used in locales where they do not apply, but not always: the constants VbStrConv.Katakana and VbStrConv.Hiragana can be used in a non-Japanese system with the Japanese Language Pack installed. Kromě toho používejte konstanty VbStrConv.Wide a podporují se VbStrConv.Narrow v jakémkoli systému, ve kterém je nainstalovaný východoasijský jazyk.In addition, use of the constants VbStrConv.Wide and VbStrConv.Narrow is supported on any system with an East Asian language installed.

Tato funkce využívá při manipulaci s řetězcem informace o jazykové verzi aplikace, aby změny velikosti písmen byly vhodné pro národní prostředí, ve kterém se aplikace používá.This function uses the application's culture information when manipulating the string so that the case changes are appropriate for the locale in which the application is being used.

Důležité

Pokud vaše aplikace provádí rozhodnutí o zabezpečení na základě výsledku porovnání nebo operace změny velikosti písmen, pak by tato operace měla používat String.Compare metodu a metodu předat Ordinal nebo OrdinalIgnoreCase pro comparisonType argument.If your application makes security decisions based on the result of a comparison or case-change operation, then the operation should use the String.Compare method, and pass Ordinal or OrdinalIgnoreCase for the comparisonType argument. Další informace naleznete v tématu vliv jazykové verze na řetězce v Visual Basic.For more information, see How Culture Affects Strings in Visual Basic.

ConversionNastavení argumentů jsou:The Conversion argument settings are:

Člen výčtuEnumeration member	DescriptionDescription
`VbStrConv.None`	Neprovede žádný převod.Performs no conversion
`VbStrConv.LinguisticCasing`	Používá jazyková pravidla pro velká a malá písmena, nikoli systém souborů (výchozí).Uses linguistic rules for casing, rather than File System (default). Platí `VbStrConv.UpperCase` pouze pro a `VbStrConv.LowerCase` .Valid with `VbStrConv.UpperCase` and `VbStrConv.LowerCase` only.
`VbStrConv.UpperCase`	Převede řetězec na velká písmena.Converts the string to uppercase characters.
`VbStrConv.LowerCase`	Převede řetězec na malá písmena.Converts the string to lowercase characters.
`VbStrConv.ProperCase`	Převede první písmeno každého slova v řetězci na velká.Converts the first letter of every word in string to uppercase.
`VbStrConv.Wide` ^`VbStrConv.Wide` ^	Převede zúžené znaky (s poloviční šířkou) v řetězci na široké (plné šířky) znaky.Converts narrow (half-width) characters in the string to wide (full-width) characters. Převod může použít formu normalizace C i v případě, že vstupní znak je již plná šířka.The conversion may use Normalization Form C even if an input character is already full-width. Například řetězec "ば" (který je již na celé šířce) je normalizován na "ば".For example, the string "は゛" (which is already full-width) is normalized to "ば". Viz formy normalizace Unicode.See Unicode normalization forms.
`VbStrConv.Narrow` ^`VbStrConv.Narrow` ^	Převede široké (s plnou šířkou) znaků v řetězci na zúžené znaky (s poloviční šířkou).Converts wide (full-width) characters in the string to narrow (half-width) characters.
`VbStrConv.Katakana` ^`VbStrConv.Katakana` ^	Převede znaky Hiragana v řetězci na znaky Katakana.Converts Hiragana characters in the string to Katakana characters.
`VbStrConv.Hiragana` ^`VbStrConv.Hiragana` ^	Převede znaky Katakana v řetězci na znaky Hiragana.Converts Katakana characters in the string to Hiragana characters.
`VbStrConv.SimplifiedChinese` ^`VbStrConv.SimplifiedChinese` ^	Převede tradiční čínské znaky na zjednodušenou čínštinu.Converts Traditional Chinese characters to Simplified Chinese.
`VbStrConv.TraditionalChinese` ^`VbStrConv.TraditionalChinese` ^	Převede zjednodušené čínské znaky na tradiční čínštinu.Converts Simplified Chinese characters to Traditional Chinese.

^* Platí pro asijské národní prostředí.^* Applies to Asian locales.

^** Platí jenom pro Japonsko.^** Applies to Japan only.

Poznámka

Tyto konstanty jsou určené v modulu CLR .NET Framework Common Language Runtime.These constants are specified in the .NET Framework common language runtime. V důsledku toho je lze použít kdekoli v kódu místo skutečných hodnot.As a result, they can be used anywhere in your code in place of the actual values. Většinu lze kombinovat (například UpperCase + Wide ), s výjimkou případů, kdy se vzájemně vylučují (například VbStrConv.Wide + VbStrConv.Narrow ).Most can be combined (for example, UpperCase + Wide), except when they are mutually exclusive (for example, VbStrConv.Wide + VbStrConv.Narrow).

Níže jsou platné oddělovače slov pro správné používání velkých a malých písmen: null ( Chr$(0) ), horizontální tabulátor ( Chr$(9) ), line feed ( Chr$(10) ), Vertikální tabelátor ( Chr$(11) ), tvarový kanál (), návratový znak ( Chr$(12) Chr$(13) ), mezera (jednobajtové znakové sady) ( Chr$(32) ).The following are valid word separators for proper casing: Null (Chr$(0)), horizontal tab (Chr$(9)), line feed (Chr$(10)), vertical tab (Chr$(11)), form feed (Chr$(12)), carriage return (Chr$(13)), space (single-byte character set) (Chr$(32)). Skutečná hodnota pro mezeru, která může být plná nebo poloviční, se liší podle země/oblasti pro východoasijské jazykové verze.The actual value for a space, which can be full or half width, varies by country/region for East Asian cultures.

Platí pro