Strings.StrConv(String, VbStrConv, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定に従って変換された文字列型の値を返します。
[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 -> stringstatic 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.Hiragana``VbStrConv.Katakana``VbStrConv.TraditionalChineseおよび適用されないロケールで使用すると、実行時エラーが発生する可能性がありますが、常にそうであるとは限りません。定数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共通言語ランタイムで指定されます。 その結果、実際の値の代わりにコード内の任意の場所で使用できます。 相互に排他的な場合 (たとえば) を除き、 UpperCase + Wideほとんどの組み合わせ (たとえば) VbStrConv.Wide + VbStrConv.Narrowを行うことができます。
正しい大文字と小文字を区別するための有効な単語区切り記号を次に示します。Null (Chr$(0))、水平タブ (Chr$(9))、改行 (Chr$(10))、垂直タブ (Chr$(11))、フォーム フィード (Chr$(12))、復帰 (Chr$(13))、スペース (1 バイト文字セット) (Chr$(32))。 スペースの実際の値 (幅の全体または半分) は、東アジアの文化の国/地域によって異なります。