Strings.StrConv(String, VbStrConv, Int32) メソッド

  • リファレンス

定義

名前空間:
Microsoft.VisualBasic
アセンブリ:
Microsoft.VisualBasic.Core.dll
アセンブリ:
Microsoft.VisualBasic.dll
ソース:
Strings.vb
ソース:
Strings.vb
ソース:
Strings.vb

指定したとおりに変換された文字列を返します。

[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

パラメーター

str
String

必須。 変換する式 String します。

Conversion
VbStrConv

必須。 メンバー VbStrConv します。 実行する変換の種類を指定する列挙値。

LocaleID
Int32

随意。 システム LocaleID 値と異なる場合は、LocaleID 値。 (システム LocaleID の値が既定値です)。

戻り値

String

指定したとおりに変換された文字列。

属性
SupportedOSPlatformAttribute

例外

ArgumentException

サポートされていない LocaleID、Conversion< 0 または > 2048、または指定されたロケールのサポートされていない変換。

例

次の使用例は、テキストをすべての小文字に変換します。

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

注釈

定数 VbStrConv.Wide、VbStrConv.Narrow、VbStrConv.SimplifiedChinese、VbStrConv.TraditionalChinese、VbStrConv.Katakana、および VbStrConv.Hiragana は、適用されないロケールで使用すると実行時エラーを引き起こす可能性がありますが、必ずしもそうではなく、日本語言語パックがインストールされている日本語以外のシステムで定数 VbStrConv.Katakana と VbStrConv.Hiragana を使用できます。 さらに、VbStrConv.Wide および VbStrConv.Narrow の定数の使用は、東アジア言語がインストールされている任意のシステムでサポートされています。

この関数は、文字列を操作するときにアプリケーションのカルチャ情報を使用して、アプリケーションが使用されているロケールに対して大文字と小文字の変更が適切になるようにします。

大事な

アプリケーションで比較操作または大文字と小文字の変更操作の結果に基づいてセキュリティ上の決定を行う場合、操作では String.Compare メソッドを使用し、comparisonType 引数に Ordinal または OrdinalIgnoreCase を渡す必要があります。 詳細については、「Visual Basicでのカルチャの文字列への影響の 」を参照してください。

Conversion 引数の設定は次のとおりです。

列挙メンバー 形容
VbStrConv.None 変換を実行しない
VbStrConv.LinguisticCasing ファイル システム (既定) ではなく、大文字と小文字の区別に言語規則を使用します。 VbStrConv.UpperCase および VbStrConv.LowerCase でのみ有効です。
VbStrConv.UpperCase 文字列を大文字に変換します。
VbStrConv.LowerCase 文字列を小文字に変換します。
VbStrConv.ProperCase 文字列内のすべての単語の最初の文字を大文字に変換します。
VbStrConv.Wide * 文字列内の狭い (半角) 文字をワイド (全角) 文字に変換します。 変換では、入力文字が既に全角である場合でも、正規化フォーム C を使用できます。 たとえば、文字列 "は ゙" (既に全角) は "ば" に正規化されます。 Unicode 正規化形式 を参照してください。
VbStrConv.Narrow * 文字列内のワイド (全角) 文字を狭い (半角) 文字に変換します。
VbStrConv.Katakana ** 文字列内のひらがな文字をカタカナ文字に変換します。
VbStrConv.Hiragana ** 文字列内のカタカナ文字をひらがな文字に変換します。
VbStrConv.SimplifiedChinese * 繁体字中国語を簡体字中国語に変換します。
VbStrConv.TraditionalChinese * 簡体字中国語を繁体字中国語に変換します。

* アジアロケールに適用されます。

** 日本に限り適用されます。

手記

これらの定数は、.NET Framework 共通言語ランタイムで指定されます。 その結果、実際の値の代わりにコード内の任意の場所で使用できます。 相互に排他的な場合 (たとえば、VbStrConv.Wide + VbStrConv.Narrow) を除き、ほとんどの組み合わせ (たとえば、UpperCase + Wide)。

正しい大文字と小文字を区別するための有効な単語区切り記号は、Null (Chr$(0))、水平タブ (Chr$(9))、改行 (Chr$(10))、垂直タブ (Chr$(11))、フォーム フィード (Chr$(12))、復帰 (Chr$(13))、スペース (1 バイト文字セット) (Chr$(32)) です。 スペースの実際の値 (幅の全体または半分) は、東アジアの文化の国/地域によって異なります。

適用対象

こちらもご覧ください