StringLengthAttribute クラス

定義

データ フィールドで使用できる最小文字長と最大文字長を指定します。Specifies the minimum and maximum length of characters that are allowed in a data field.

public ref class StringLengthAttribute : System::ComponentModel::DataAnnotations::ValidationAttribute
[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)]
[System.AttributeUsage]
[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)]
public class StringLengthAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute
type StringLengthAttribute = class
    inherit ValidationAttribute
Public Class StringLengthAttribute
Inherits ValidationAttribute
継承
StringLengthAttribute
属性

次の例は、フィールド内の文字数を制限する方法を示しています。The following example shows how to limit the number of characters in a field. この例では、AdventureWorksLT データベースの Products テーブルの ThumbnailPhotoFileName フィールドを使用します。This example works with the ThumbnailPhotoFileName field in the Products table in the AdventureWorksLT database. フィールドには、Product エンティティを表す部分クラスに StringLengthAttribute 属性を適用することによって、4文字が制限されます。The field is limited 4 characters by applying the StringLengthAttribute attribute to the partial class that represents the Product entity.

[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 (作成、読み取り、更新、および削除) 操作が可能になります。ASP.NET Dynamic Data enables CRUD (Create, Read, Update and Delete) operations in a data model. データを挿入または更新するときに、各フィールドの文字の最小値と最大長を指定できます。You can specify the minimum and maximum length of characters for each field when data is being inserted or updated. 文字データ型の場合、MinimumLength プロパティと MaximumLength プロパティは、文字列を格納するために必要な最大バイト数を指定します。For character data types, the MinimumLength and MaximumLength properties identify the largest number of bytes that are required in order to store a string.

エラーメッセージには、複合書式指定プレースホルダーを使用できます。 {0} はプロパティの名前です。{1} は最大長です。と {2} が最小の長さです。You can use composite formatting placeholders in the error message: {0} is the name of the property; {1} is the maximum length; and {2} is the minimum length. プレースホルダーは、実行時に String.Format メソッドに渡される引数に対応します。The placeholders correspond to arguments that are passed to the String.Format method at runtime.

コンストラクター

StringLengthAttribute(Int32)

指定した最大長を使用して、StringLengthAttribute クラスの新しいインスタンスを初期化します。Initializes a new instance of the StringLengthAttribute class by using a specified maximum length.

プロパティ

ErrorMessage

検証が失敗した場合に検証コントロールに関連付けるエラー メッセージを取得または設定します。Gets or sets an error message to associate with a validation control if validation fails.

(継承元 ValidationAttribute)
ErrorMessageResourceName

検証が失敗した場合に ErrorMessageResourceType プロパティ値の検索に使用するエラー メッセージ リソース名を取得または設定します。Gets or sets the error message resource name to use in order to look up the ErrorMessageResourceType property value if validation fails.

(継承元 ValidationAttribute)
ErrorMessageResourceType

検証が失敗した場合にエラー メッセージの検索に使用するリソースの種類を取得または設定します。Gets or sets the resource type to use for error-message lookup if validation fails.

(継承元 ValidationAttribute)
ErrorMessageString

ローカライズされた検証エラー メッセージを取得します。Gets the localized validation error message.

(継承元 ValidationAttribute)
MaximumLength

文字列の最大長を取得または設定します。Gets or sets the maximum length of a string.

MinimumLength

文字列の最小長を取得または設定します。Gets or sets the minimum length of a string.

RequiresValidationContext

属性で検証コンテキストが必要かどうかを示す値を取得します。Gets a value that indicates whether the attribute requires validation context.

(継承元 ValidationAttribute)
TypeId

派生クラスで実装されると、この Attribute の一意の識別子を取得します。When implemented in a derived class, gets a unique identifier for this Attribute.

(継承元 Attribute)

メソッド

Equals(Object)

このインスタンスが、指定されたオブジェクトと等価であるかどうかを示す値を返します。Returns a value that indicates whether this instance is equal to a specified object.

(継承元 Attribute)
FormatErrorMessage(String)

指定したエラー メッセージに書式を適用しますApplies formatting to a specified error message.

GetHashCode()

このインスタンスのハッシュ コードを返します。Returns the hash code for this instance.

(継承元 Attribute)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
GetValidationResult(Object, ValidationContext)

現在の検証属性に対して、指定した値が有効かどうかを確認します。Checks whether the specified value is valid with respect to the current validation attribute.

(継承元 ValidationAttribute)
IsDefaultAttribute()

派生クラスでオーバーライドされるとき、このインスタンスの値が派生クラスの既定値であるかどうかを示します。When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(継承元 Attribute)
IsValid(Object)

指定したオブジェクトが有効かどうかを判断しますDetermines whether a specified object is valid.

IsValid(Object, ValidationContext)

現在の検証属性に対して、指定した値を検証します。Validates the specified value with respect to the current validation attribute.

(継承元 ValidationAttribute)
Match(Object)

派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(継承元 Attribute)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
ToString()

現在のオブジェクトを表す string を返します。Returns a string that represents the current object.

(継承元 Object)
Validate(Object, String)

指定されたオブジェクトを検証します。Validates the specified object.

(継承元 ValidationAttribute)
Validate(Object, ValidationContext)

指定されたオブジェクトを検証します。Validates the specified object.

(継承元 ValidationAttribute)

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

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

一連の名前を対応する一連のディスパッチ識別子に割り当てます。Maps a set of names to a corresponding set of dispatch identifiers.

(継承元 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

オブジェクトの型情報を取得します。この情報はインターフェイスの型情報の取得に使用できます。Retrieves the type information for an object, which can be used to get the type information for an interface.

(継承元 Attribute)
_Attribute.GetTypeInfoCount(UInt32)

オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(継承元 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。Provides access to properties and methods exposed by an object.

(継承元 Attribute)

適用対象