Strings.StrConv(String, VbStrConv, Int32) Yöntem

Tanım

Belirtilen şekilde dönüştürülmüş bir dize döndürür.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

Parametreler

str
String

Gereklidir.Required. String dönüştürülecek ifade.String expression to be converted.

Conversion
VbStrConv

Gereklidir.Required. VbStrConv üyesidir.VbStrConv member. Gerçekleştirilecek dönüştürme türünü belirten numaralandırma değeri.The enumeration value specifying the type of conversion to perform.

LocaleID
Int32

İsteğe bağlı.Optional. LocaleIDDeğer, sistem LocaleID değerinden farklıysa.The LocaleID value, if different from the system LocaleID value. (Sistem LocaleID değeri varsayılandır.)(The system LocaleID value is the default.)

Döndürülenler

String

Belirtilen şekilde dönüştürülmüş bir dize.A string converted as specified.

Öznitelikler

Özel durumlar

Desteklenmeyen LocaleID , Conversion < 0 veya > 2048 ya da belirtilen yerel ayar için desteklenmeyen dönüştürme.Unsupported LocaleID, Conversion < 0 or > 2048, or unsupported conversion for specified locale.

Örnekler

Bu örnek, metni tüm küçük harflere dönüştürür.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)

Açıklamalar

,,,, Ve sabitleri, VbStrConv.Wide VbStrConv.Narrow VbStrConv.SimplifiedChinese VbStrConv.TraditionalChinese VbStrConv.Katakana VbStrConv.Hiragana her zaman uygulamadıkları, ancak her zaman değil, Japonca VbStrConv.Katakana VbStrConv.Hiragana olmayan bir sistemde kullanıldığında çalışma zamanı hatalarına neden olabilir.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. Ayrıca, sabitlerin kullanılması VbStrConv.Wide ve VbStrConv.Narrow Doğu Asya dili yüklü olan tüm sistemlerinde desteklenir.In addition, use of the constants VbStrConv.Wide and VbStrConv.Narrow is supported on any system with an East Asian language installed.

Bu işlev, dizeyi işlerken uygulamanın kültür bilgilerini kullanır. Böylece büyük/küçük harf değişikliklerinin, uygulamanın kullanılmakta olduğu yerel ayar için uygun olması sağlanır.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.

Önemli

Uygulamanız bir karşılaştırma veya örnek değişikliği işleminin sonucuna göre güvenlik kararları alıyorsa, işlem String.Compare yöntemini kullanmalı ve Ordinal OrdinalIgnoreCase comparisonType bağımsız değişkeni iletmeli.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. Daha fazla bilgi için bkz. kültür Visual Basic Içindeki dizeleri nasıl etkiler.For more information, see How Culture Affects Strings in Visual Basic.

ConversionBağımsız değişken ayarları şunlardır:The Conversion argument settings are:

Sabit listesi üyesiEnumeration member DescriptionDescription
VbStrConv.None Dönüştürme gerçekleştirmesizPerforms no conversion
VbStrConv.LinguisticCasing Dosya sistemi (varsayılan) yerine, büyük küçük harf için dil kuralları kullanır.Uses linguistic rules for casing, rather than File System (default). VbStrConv.UpperCaseYalnızca ve ile geçerlidir VbStrConv.LowerCase .Valid with VbStrConv.UpperCase and VbStrConv.LowerCase only.
VbStrConv.UpperCase Dizeyi büyük harfli karakterlere dönüştürür.Converts the string to uppercase characters.
VbStrConv.LowerCase Dizeyi küçük harfli karakterlere dönüştürür.Converts the string to lowercase characters.
VbStrConv.ProperCase Dizedeki her sözcüğün ilk harfini büyük harfe dönüştürür.Converts the first letter of every word in string to uppercase.
VbStrConv.Wide *VbStrConv.Wide * Dizedeki dar (yarım genişlik) karakterleri geniş (tam genişlikli) karakterlere dönüştürür.Converts narrow (half-width) characters in the string to wide (full-width) characters. Bir giriş karakteri zaten tam genişliğe sahip olsa bile dönüştürme, normalleştirme biçimi C kullanabilir.The conversion may use Normalization Form C even if an input character is already full-width. Örneğin, "は ゙" (zaten tam genişlik olan) dizesi "ば" olarak normalleştirilmelidir.For example, the string "は゛" (which is already full-width) is normalized to "ば". Bkz. Unicode normalleştirme formları.See Unicode normalization forms.
VbStrConv.Narrow *VbStrConv.Narrow * Dizedeki geniş (tam genişlikli) karakterleri dar (yarı genişlik) karakterlere dönüştürür.Converts wide (full-width) characters in the string to narrow (half-width) characters.
VbStrConv.Katakana **VbStrConv.Katakana ** Dizedeki Hiragana karakterleri katakana karakterlerine dönüştürür.Converts Hiragana characters in the string to Katakana characters.
VbStrConv.Hiragana **VbStrConv.Hiragana ** Dizedeki Katakana karakterlerini Hiragana karakterlere dönüştürür.Converts Katakana characters in the string to Hiragana characters.
VbStrConv.SimplifiedChinese *VbStrConv.SimplifiedChinese * Geleneksel Çince karakterleri Basitleştirilmiş Çince 'ye dönüştürür.Converts Traditional Chinese characters to Simplified Chinese.
VbStrConv.TraditionalChinese *VbStrConv.TraditionalChinese * Basitleştirilmiş Çince karakterleri geleneksel çiye dönüştürür.Converts Simplified Chinese characters to Traditional Chinese.

* Asya yerel ayarları için geçerlidir.* Applies to Asian locales.

** Yalnızca Japonya için geçerlidir.** Applies to Japan only.

Not

Bu sabitler .NET Framework ortak dil çalışma zamanında belirtilmiştir.These constants are specified in the .NET Framework common language runtime. Sonuç olarak, kodunuzda gerçek değerlerin yerine her yerde kullanılabilir.As a result, they can be used anywhere in your code in place of the actual values. Çoğu, UpperCase + Wide birbirini dışlamalı (örneğin,) hariç olmak üzere birleştirilebilecek (örneğin,) VbStrConv.Wide + VbStrConv.Narrow .Most can be combined (for example, UpperCase + Wide), except when they are mutually exclusive (for example, VbStrConv.Wide + VbStrConv.Narrow).

Doğru büyük/küçük harf için geçerli sözcük ayırıcıları şunlardır: null ( Chr$(0) ), yatay sekme ( Chr$(9) ), satır besleme ( Chr$(10) ), dikey sekme (), Chr$(11) form akışı (), satır başı Chr$(12) ( Chr$(13) ), boşluk (tek baytlı karakter kümesi) ( 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)). Tam veya yarı genişlik olabilen bir alanın gerçek değeri, Doğu Asya kültürleri için ülkeye/bölgeye göre farklılık gösterir.The actual value for a space, which can be full or half width, varies by country/region for East Asian cultures.

Şunlara uygulanır

Ayrıca bkz.