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.NarrowVbStrConv.SimplifiedChinese、、VbStrConv.TraditionalChineseVbStrConv.Katakana、および VbStrConv.Hiragana は、適用されないロケールで使用すると実行時エラーを引き起こす可能性がありますが、常にとは限りません。定数VbStrConv.Katakanaと VbStrConv.Hiragana は、日本語言語パックがインストールされている日本語以外のシステムで使用できます。 さらに、定数 VbStrConv.WideVbStrConv.Narrow と の使用は、東アジア言語がインストールされている任意のシステムでサポートされています。

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

重要

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

Conversion 引数の設定は以下の通りです。

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

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

** 日本のみに適用されます。

注意

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

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

適用対象

こちらもご覧ください