Strings.StrConv(String, VbStrConv, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したとおりに変換された文字列を返します。
public static string StrConv(string str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);static member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> stringPublic Function StrConv (str As String, Conversion As VbStrConv, Optional LocaleID As Integer = 0) As Stringパラメーター
- str
- String
必須。
String 変換する式。
- LocaleID
- Int32
オプション。 システムLocaleID値と異なる場合は、LocaleID値。 (システム LocaleID の値が既定値です)。
返品
指定したとおりに変換された文字列。
例外
サポートされていない 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 の定数の使用は、東アジア言語がインストールされている任意のシステムでサポートされています。
この関数は、文字列を操作するときにアプリケーションのカルチャ情報を使用して、アプリケーションが使用されているロケールに対して大文字と小文字の変更が適切になるようにします。
Important
アプリケーションが比較操作または大文字と小文字の変更操作の結果に基づいてセキュリティ上の決定を行う場合、操作では String.Compare メソッドを使用し、Ordinal引数にOrdinalIgnoreCaseまたはcomparisonTypeを渡す必要があります。 詳細については、「
Conversion引数の設定は次のとおりです。
| 列挙メンバー | Description |
|---|---|
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
*
|
簡体字中国語を繁体字中国語に変換します。 |
* アジアロケールに適用されます。
** 日本にのみ適用されます。
Note
これらの定数は、.NET Framework 共通言語ランタイムで指定されます。 その結果、実際の値の代わりにコード内の任意の場所で使用できます。 相互に排他的な場合 (たとえば、VbStrConv.Wide + VbStrConv.Narrow) を除き、ほとんどの組み合わせ (たとえば、UpperCase + Wide)。
正しい大文字と小文字を区別するための有効な単語区切り記号は、Null (Chr$(0))、水平タブ (Chr$(9))、改行 (Chr$(10))、垂直タブ (Chr$(11))、フォーム フィード (Chr$(12))、復帰 (Chr$(13))、スペース (1 バイト文字セット) (Chr$(32)) です。 スペースの実際の値 (幅の全体または半分) は、東アジアの文化の国/地域によって異なります。