C#のUri.IsHexEncoding()メソッドとは？使い方とサンプルコードを解説

C#のUri.IsHexEncoding()メソッドは、文字列内の指定した位置にある文字が、URIで使用される「%XX」形式の16進数エンコード（パーセントエンコーディング）になっているかどうかを判定するための静的メソッドです。

構文

Uri.IsHexEncoding()メソッドの構文は以下のとおりです。

public static bool IsHexEncoding (string pattern, int index);

パラメータ

• pattern：チェック対象となる文字列
• index：16進数エンコードかどうかを確認する、pattern内の位置（インデックス）

戻り値はbool型で、指定位置が有効な16進数エンコードであればtrue、そうでなければfalseを返します。

例1：有効な16進数エンコードを判定する

まず、Uri.IsHexEncoding()メソッドを使用して、文字列「%50」が16進数エンコードとして有効かどうかを確認してみましょう。

using System;
public class Demo {
   public static void Main(){
      string pattern = "%50";
      bool res = Uri.IsHexEncoding(pattern, 0);
      if (res)
         Console.WriteLine("Valid: Hexadecimal Encoded");
      else
         Console.WriteLine("Invalid: Hexadecimal Encoded");
   }
}

出力

Valid: Hexadecimal Encoded

この例では、インデックス0（先頭）に「%」があり、その後に続く2文字「50」が有効な16進数であるため、trueが返されています。

例2：無効なケースを判定する

次に、チェック位置をずらした場合の動作を見てみましょう。

using System;
public class Demo {
   public static void Main(){
      string pattern = "%60";
      bool res = Uri.IsHexEncoding(pattern, 1);
      if (res)
         Console.WriteLine("Valid: Hexadecimal Encoded");
      else
         Console.WriteLine("Invalid: Hexadecimal Encoded");
   }
}

出力

Invalid: Hexadecimal Encoded

この例では、インデックス1に指定されたのは「6」という数字であり、「%」から始まる16進数エンコードの形式ではないため、falseが返されます。このように、Uri.IsHexEncoding()メソッドは指定したインデックスの位置から「%XX」という形式が成立しているかどうかを厳密にチェックします。

まとめ

Uri.IsHexEncoding()メソッドを使うことで、URLやURIに含まれる文字列が正しくパーセントエンコーディングされているかどうかを簡単に検証できます。ユーザー入力のURLを処理する際や、エンコード済みの文字列をデコードする前のバリデーションなどに活用すると便利です。