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 -> 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
型の式。
- 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
と の使用は、東アジア言語がインストールされている任意のシステムでサポートされています。
この関数は、文字列を操作するときにアプリケーションのカルチャ情報を使用して、アプリケーションが使用されているロケールに合わせて大文字と小文字の変更が適切になるようにします。
重要
アプリケーションが、比較操作または大文字/小文字の変更操作の結果に基づいてセキュリティ上の決定を行う場合は、操作で 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)
)。 スペースの実際の値は、全角または半角で指定できます。これは、東アジアの文化の国/地域によって異なります。
適用対象
こちらもご覧ください
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示