StringLengthAttribute クラス

定義

名前空間:

System.ComponentModel.DataAnnotations

アセンブリ:

System.ComponentModel.DataAnnotations.dll

データ フィールドで使用できる文字の最小長と最大長を指定します。

public ref class StringLengthAttribute : System::ComponentModel::DataAnnotations::ValidationAttribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)]
public class StringLengthAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type StringLengthAttribute = class
    inherit ValidationAttribute

Public Class StringLengthAttribute
Inherits ValidationAttribute

継承

Object

Attribute

ValidationAttribute

StringLengthAttribute

属性

AttributeUsageAttribute

例

次の例は、フィールドの文字数を制限する方法を示しています。 次の使用例は、AdventureWorksLT データベースの Products テーブルの ThumbnailPhotoFileName フィールドを操作します。 このフィールドは、Product エンティティを表す部分クラスに StringLengthAttribute 属性を適用することで、4 文字に制限されます。

[MetadataType(typeof(ProductMetadata))]
public partial class Product
{

}

public class ProductMetadata
{

    [ScaffoldColumn(true)]
    [StringLength(4, ErrorMessage = "The ThumbnailPhotoFileName value cannot exceed 4 characters. ")]
    public object ThumbnailPhotoFileName;

    [ScaffoldColumn(true)]
    [StringLength(4, ErrorMessage = "The {0} value cannot exceed {1} characters. ")]
    public object PhotoFileName;

}

<MetadataType(GetType(ProductMetadata))> _
Public Partial Class Product

End Class

Public Class ProductMetadata

    <ScaffoldColumn(True)> _
    <StringLength(4, ErrorMessage := "The ThumbnailPhotoFileName value cannot exceed 4 characters. ")> _
    Public ThumbnailPhotoFileName As Object

    <ScaffoldColumn(True)> _
    <StringLength(4, ErrorMessage := "The {0} value cannot exceed {1} characters. ")> _
    Public PhotoFileName As Object

End Class

注釈

動的データ ASP.NET、データ モデルで CRUD (作成、読み取り、更新、および削除) 操作を有効にします。 データの挿入または更新時に、各フィールドの文字の最小長と最大長を指定できます。 文字データ型の場合、 MinimumLength プロパティと MaximumLength プロパティは、文字列を格納するために必要な最大バイト数を識別します。

複合書式プレースホルダーは、エラー メッセージで使用できます。{0}はプロパティの名前です。{1}は最大長、{2}は最小長です。 プレースホルダーは、実行時に String.Format メソッドに渡される引数に対応します。

コンストラクター

名前	説明
StringLengthAttribute(Int32)	指定した最大長を使用して、 StringLengthAttribute クラスの新しいインスタンスを初期化します。

プロパティ

名前	説明
ErrorMessage	検証が失敗した場合に検証コントロールに関連付けるエラー メッセージを取得または設定します。 (継承元 ValidationAttribute)
ErrorMessageResourceName	検証が失敗した場合に ErrorMessageResourceType プロパティ値を検索するために使用するエラー メッセージ リソース名を取得または設定します。 (継承元 ValidationAttribute)
ErrorMessageResourceType	検証が失敗した場合にエラー メッセージ検索に使用するリソースの種類を取得または設定します。 (継承元 ValidationAttribute)
ErrorMessageString	ローカライズされた検証エラー メッセージを取得します。 (継承元 ValidationAttribute)
MaximumLength	文字列の最大長を取得または設定します。
MinimumLength	文字列の最小長を取得または設定します。
RequiresValidationContext	属性に検証コンテキストが必要かどうかを示す値を取得します。 (継承元 ValidationAttribute)
TypeId	派生クラスで実装されている場合は、この Attributeの一意の識別子を取得します。 (継承元 Attribute)

メソッド

名前	説明
Equals(Object)	このインスタンスが指定したオブジェクトと等しいかどうかを示す値を返します。 (継承元 Attribute)
FormatErrorMessage(String)	指定したエラー メッセージに書式を適用します。
GetHashCode()	このインスタンスのハッシュ コードを返します。 (継承元 Attribute)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetValidationResult(Object, ValidationContext)	現在の検証属性に関して、指定した値が有効かどうかを確認します。 (継承元 ValidationAttribute)
IsDefaultAttribute()	派生クラスでオーバーライドされた場合、このインスタンスの値が派生クラスの既定値であるかどうかを示します。 (継承元 Attribute)
IsValid(Object, ValidationContext)	現在の検証属性に関して、指定した値を検証します。 (継承元 ValidationAttribute)
IsValid(Object)	指定したオブジェクトが有効かどうかを判断します。
Match(Object)	派生クラスでオーバーライドされた場合、このインスタンスが指定したオブジェクトと等しいかどうかを示す値を返します。 (継承元 Attribute)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
Validate(Object, String)	指定したオブジェクトを検証します。 (継承元 ValidationAttribute)
Validate(Object, ValidationContext)	指定したオブジェクトを検証します。 (継承元 ValidationAttribute)

明示的なインターフェイスの実装

名前	説明
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	一連の名前を対応する一連のディスパッチ識別子に割り当てます。 (継承元 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	インターフェイスの型情報を取得するために使用できるオブジェクトの型情報を取得します。 (継承元 Attribute)
_Attribute.GetTypeInfoCount(UInt32)	オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。 (継承元 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	オブジェクトによって公開されるプロパティとメソッドへのアクセスを提供します。 (継承元 Attribute)