郵便番号コントロールの機能は、「JPAddress for .NET（以下、JPAddress）」を利用して実現されており、検索機能を利用するためにはJPAddress のインストールおよび開発ライセンスが必要です。また、検索機能を使用するためには、JPAddress のGcJPAddress コンポーネントをページに配置する必要があります。
詳細については「JPAddress for .NETとの連携」を参照してください。

郵便番号コントロールの入力フィールドには次の4つのフィールドが設定されており、これらのフィールドオブジェクトを使って書式が設定されています。なお、これらの入力フィールドはFields プロパティから参照されています。

• ZipCodePrefix （接頭語のフィールド）
• ZipCode3Digits （郵便番号上位 3桁フィールド）
• ZipCodeSeparator （区切りフィールド）
• NumberDecimalPartField （郵便番号下位 4桁フィールド）

郵便番号コントロールでは、これらのフィールドを追加したり削除したりすることはできません。接頭語やリテラルを非表示にしたい場合には、各フィールドのText プロパティを削除します。

また、ZipCodeCharType プロパティを使用すると、入力可能な郵便番号用数値を全角か半角かのとちらかに限定することができます。

郵便番号コントロールは入力された郵便番号から住所などの検索を行い、検索結果を指定したコントロールに出力します。QueryMode プロパティで住所の郵便番号と大口事業所の個別郵便番号、もしくはその両方を対象として検索を行うかどうかを設定できます。

検索結果を出力するコントロールは以下のプロパティで設定します。また、住所情報が変更されたときにはAddressOutputting イベントが発生します。

• AddressOutput （検索結果の「住所」を出力するコントロールを取得または設定します。）
• AddressKanaOutput （検索結果の「住所（フリガナ）」を出力するコントロールを取得または設定します。）

次のサンプルコードは、テキストコントロールに住所の郵便番号の結果を出力します。郵便番号は全角で表示します。

Imports GrapeCity.Win.Editors

' 住所と住所のカナを出力するコントロールを指定します。
GcPostal1.AddressOutput = GcTextBox1
GcPostal1.AddressKanaOutput = GcTextBox2

' 検索対象に住所の郵便番号を指定します。
GcPostal1.QueryMode = GcAddressProvider.ZipCodeQueryMode.GeneralZipCode
' 郵便番号を全角で表示します。
GcPostal1.ZipCodeCharType = ZipCodeCharType.FullWidthDigit

using GrapeCity.Win.Editors;

// 住所と住所のカナを出力するコントロールを指定します。
gcPostal1.AddressOutput = gcTextBox1;
gcPostal1.AddressKanaOutput = gcTextBox2;

// 検索対象に住所の郵便番号を指定します。
gcPostal1.QueryMode = GcAddressProvider.ZipCodeQueryMode.GeneralZipCode;
// 郵便番号を全角で表示します。
gcPostal1.ZipCodeCharType = ZipCodeCharType.FullWidthDigit;

郵便番号から検索される住所などの情報は、次の2つのプロパティによって結果をカスタマイズできます。

SplitAreaDetails プロパティ

同じ郵便番号に複数の丁目が含まれているときにそれぞれを分割するかどうかを取得または設定します。
郵便番号によっては、ひとつの郵便番号に複数の丁目が含まれている場合があります。こういった場合に、それぞれを分割して別々のレコードとするか、複数の丁目がまとまったままのひとつのレコードとするかを設定します。

たとえば、〒105-0022は「東京都港区海岸（１、２丁目）」と登録されています。これを

• 東京都港区海岸１丁目
• 東京都港区海岸２丁目

と別々のレコードとして扱うか

• 東京都港区海岸（１、２丁目）

とひとつのレコードとして扱うかを指定します。

SplitAreaDetails プロパティをTrue に設定してそれぞれを別々のレコードとして扱った場合、分割した最初のレコードが検索結果として返されます。

GenerateCompanyAddressKana プロパティ

大口事業所の検索結果に住所のカナを含めるかどうかを取得または設定します。
大口事業所の個別郵便番号の検索結果にのみ有効です。住所の郵便番号の場合には住所のカナは必ず含まれます。