Strings.StrConv(String, VbStrConv, Int32) Strings.StrConv(String, VbStrConv, Int32) Strings.StrConv(String, VbStrConv, Int32) Method


指定に従って変換された文字列型の値を返します。Returns a string converted as specified.

public static string StrConv (string str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);
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


String String String

必須です。Required. 変換する String 型の式。String expression to be converted.

VbStrConv VbStrConv VbStrConv

必須です。Required. VbStrConv のメンバー。VbStrConv member. 実行する比較の種類を指定する列挙値。The enumeration value specifying the type of conversion to perform.

Int32 Int32 Int32

任意。Optional. システム LocaleID 値と異なる場合の LocaleID 値。The LocaleID value, if different from the system LocaleID value. 既定値は、システムの LocaleID です。(The system LocaleID value is the default.)


指定どおりに変換された文字列です。A string converted as specified.


LocaleID の値がサポートされていない、Conversion が < 0 または > 2048、あるいは変換の方法が指定されたロケールでサポートされていない。Unsupported LocaleID, Conversion < 0 or > 2048, or unsupported conversion for specified locale.

この例は、テキストをすべて小文字に変換します。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)


定数VbStrConv.WideVbStrConv.NarrowVbStrConv.SimplifiedChineseVbStrConv.TraditionalChineseVbStrConv.KatakanaVbStrConv.Hiragana場所は適用されません、ロケールで使用すると、実行時エラーが発生することができますが、常にではありません: 定数VbStrConv.KatakanaVbStrConv.Hiragana日本語言語パックがインストールされて、日本語以外のシステムで使用できます。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. さらに、定数の使用VbStrConv.WideVbStrConv.Narrow東アジア言語がインストールされている任意のシステムでサポートされます。In addition, use of the constants VbStrConv.Wide and VbStrConv.Narrow is supported on any system with an East Asian language installed.

この関数は、大文字と小文字の変更は、アプリケーションが使用されているロケールに対応できるように、文字列を操作するときに、アプリケーションのカルチャ情報を使用します。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.


アプリケーションがセキュリティ上の決定の比較またはケース変更操作の結果に基づくかどうかは、操作を使用する必要があります、String.Compareメソッド、およびパスOrdinalまたはOrdinalIgnoreCasecomparisonType引数。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. 詳細については、次を参照してください。どのカルチャに影響を与えます Visual Basic における文字列します。For more information, see How Culture Affects Strings in Visual Basic.

Conversion 引数の設定は以下の通りです。The Conversion argument settings are:

列挙型のメンバーEnumeration member 説明Description
VbStrConv.None 変換は行われませんPerforms no conversion
VbStrConv.LinguisticCasing ファイル システム (既定値) ではなく、大文字と小文字、言語の規則を使用します。Uses linguistic rules for casing, rather than File System (default). 有効なVbStrConv.UpperCaseVbStrConv.LowerCaseのみです。Valid with VbStrConv.UpperCase and VbStrConv.LowerCase only.
VbStrConv.UpperCase 文字列を大文字に変換します。Converts the string to uppercase characters.
VbStrConv.LowerCase 文字列を小文字に変換します。Converts the string to lowercase characters.
VbStrConv.ProperCase 文字列を大文字に内の各単語の最初の文字に変換します。Converts the first letter of every word in string to uppercase.
VbStrConv.Wide *VbStrConv.Wide * 変換は、広い (全角) 文字を文字列に (半角) 文字を絞り込みます。Converts narrow (half-width) characters in the string to wide (full-width) characters. 変換では、入力文字が既に全角であっても、正規形 C が使われる場合があります。The conversion may use Normalization Form C even if an input character is already full-width. たとえば、文字列 "は゛" (既に全角です) は "ば" に正規化されます。For example, the string "は゛" (which is already full-width) is normalized to "ば". Unicode の正規形をご覧ください。See Unicode normalization forms.
VbStrConv.Narrow *VbStrConv.Narrow * (半角) 文字を文字列に広い (全角) 文字に変換します。Converts wide (full-width) characters in the string to narrow (half-width) characters.
VbStrConv.Katakana **VbStrConv.Katakana ** 文字列内のひらがな文字をカタカナ文字に変換します。Converts Hiragana characters in the string to Katakana characters.
VbStrConv.Hiragana **VbStrConv.Hiragana ** 文字列内のカタカナ文字をひらがな文字に変換します。Converts Katakana characters in the string to Hiragana characters.
VbStrConv.SimplifiedChinese *VbStrConv.SimplifiedChinese * 繁体字中国語の文字を簡体字中国語に変換します。Converts Traditional Chinese characters to Simplified Chinese.
VbStrConv.TraditionalChinese *VbStrConv.TraditionalChinese * 簡体字中国語の文字を繁体字中国語に変換します。Converts Simplified Chinese characters to Traditional Chinese.

* アジアのロケールに適用されます。* Applies to Asian locales.

** 日本にのみ適用されます。** Applies to Japan only.


これらの定数は、.NET Framework 共通言語ランタイムで指定されます。These constants are specified in the .NET Framework common language runtime. その結果が使用できます任意の場所で実際の値の代わりに、コード。As a result, they can be used anywhere in your code in place of the actual values. ほとんどを組み合わせることができます (たとえば、 UpperCase + Wide)、相互に排他的な場合以外 (たとえば、 VbStrConv.Wide + VbStrConv.Narrow)。Most can be combined (for example, UpperCase + Wide), except when they are mutually exclusive (for example, VbStrConv.Wide + VbStrConv.Narrow).

以下は、適切な大文字と小文字の有効な単語の区切り文字です。Null (Chr$(0))、水平タブ (Chr$(9))、ライン フィード (Chr$(10))、垂直タブ (Chr$(11))、フォーム フィード (Chr$(12))、キャリッジ リターン (Chr$(13))、スペース (1 バイト文字セット) (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)). 完全または幅の半分ができる、スペースの実際の値は、国/地域の東アジア言語のカルチャによって異なります。The actual value for a space, which can be full or half width, varies by country/region for East Asian cultures.