IProperty Interface

Definition

Namespace:

Microsoft.EntityFrameworkCore.Metadata

Assembly:

Microsoft.EntityFrameworkCore.dll

Package:

Microsoft.EntityFrameworkCore v9.0.0

Source:

IProperty.cs

Represents a scalar property of a structural type.

public interface IProperty : Microsoft.EntityFrameworkCore.Metadata.IPropertyBase, Microsoft.EntityFrameworkCore.Metadata.IReadOnlyProperty

type IProperty = interface
    interface IReadOnlyProperty
    interface IReadOnlyPropertyBase
    interface IReadOnlyAnnotatable
    interface IPropertyBase
    interface IAnnotatable

Public Interface IProperty
Implements IPropertyBase, IReadOnlyProperty

Derived

Microsoft.EntityFrameworkCore.Metadata.RuntimeProperty

Implements

IAnnotatable IPropertyBase IReadOnlyAnnotatable IReadOnlyProperty IReadOnlyPropertyBase

Remarks

See Modeling entity types and relationships for more information and examples.

Properties

DeclaringEntityType	Obsolete. Gets the entity type that this property belongs to.
DeclaringType	Gets the type that this property-like object belongs to. (Inherited from IReadOnlyPropertyBase)
FieldInfo	Gets the FieldInfo for the underlying CLR field for this property-like object. This may be null for shadow properties or if the backing field is not known. (Inherited from IReadOnlyPropertyBase)
IsPrimitiveCollection	A property is a primitive collection if it has an element type that matches the element type of the CLR type. (Inherited from IReadOnlyProperty)
Item[String]	Gets the value of the annotation with the given name, returning null if it does not exist. (Inherited from IReadOnlyAnnotatable)
Name	Gets the name of this property-like object. (Inherited from IReadOnlyPropertyBase)
PropertyInfo	Gets the PropertyInfo for the underlying CLR property for this property-like object. This may be null for shadow properties or if mapped directly to a field. (Inherited from IReadOnlyPropertyBase)
Sentinel	Gets the sentinel value that indicates that this property is not set. (Inherited from IReadOnlyPropertyBase)

Methods

AddRuntimeAnnotation(String, Object)	Adds a runtime annotation to this object. Throws if an annotation with the specified name already exists. (Inherited from IAnnotatable)
AnnotationsToDebugString(Int32)	Gets the debug string for all annotations declared on the object. (Inherited from IReadOnlyAnnotatable)
CreateKeyEqualityComparer<TProperty>()	Creates an IEqualityComparer<T> for values of the given property type.
FindAnnotation(String)	Gets the annotation with the given name, returning null if it does not exist. (Inherited from IReadOnlyAnnotatable)
FindContainingPrimaryKey()	Gets the primary key that uses this property (including a composite primary key in which this property is included).
FindFirstPrincipal()	Finds the first principal property that the given property is constrained by if the given property is part of a foreign key.
FindRuntimeAnnotation(String)	Gets the runtime annotation with the given name, returning null if it does not exist. (Inherited from IAnnotatable)
FindRuntimeAnnotationValue(String)	Gets the value of the runtime annotation with the given name, returning null if it does not exist. (Inherited from IAnnotatable)
FindTypeMapping()	Returns the type mapping for this property. (Inherited from IReadOnlyProperty)
GetAfterSaveBehavior()	Gets a value indicating whether or not this property can be modified after the entity is saved to the database. (Inherited from IReadOnlyProperty)
GetAnnotation(String)	Gets the annotation with the given name, throwing if it does not exist. (Inherited from IReadOnlyAnnotatable)
GetAnnotations()	Gets all annotations on the current object. (Inherited from IReadOnlyAnnotatable)
GetBeforeSaveBehavior()	Gets a value indicating whether or not this property can be modified before the entity is saved to the database. (Inherited from IReadOnlyProperty)
GetContainingForeignKeys()	Gets all foreign keys that use this property (including composite foreign keys in which this property is included).
GetContainingIndexes()	Gets all indexes that use this property (including composite indexes in which this property is included).
GetContainingKeys()	Gets all primary or alternate keys that use this property (including composite keys in which this property is included).
GetCurrentValueComparer()	Gets a IComparer<T> for comparing values in tracked IUpdateEntry entries. (Inherited from IPropertyBase)
GetElementType()	Gets the configuration for elements of the primitive collection represented by this property.
GetFieldName()	Gets the name of the backing field for this property, or null if the backing field is not known. (Inherited from IReadOnlyPropertyBase)
GetGetter()	Gets a IClrPropertyGetter for reading the value of this property. (Inherited from IPropertyBase)
GetIndex()	Gets the property index for this property. (Inherited from IPropertyBase)
GetJsonValueReaderWriter()	Gets the JsonValueReaderWriter for this property, or null if none is set. (Inherited from IReadOnlyProperty)
GetKeyValueComparer()	Gets the ValueComparer to use with keys for this property.
GetMaxLength()	Gets the maximum length of data that is allowed in this property. For example, if the property is a String then this is the maximum number of characters. (Inherited from IReadOnlyProperty)
GetMemberInfo(Boolean, Boolean)	Gets the PropertyInfo or FieldInfo that should be used to get or set a value for the given property. (Inherited from IPropertyBase)
GetOrAddRuntimeAnnotationValue<TValue,TArg>(String, Func<TArg,TValue>, TArg)	Gets the value of the runtime annotation with the given name, adding it if one does not exist. (Inherited from IAnnotatable)
GetPrecision()	Gets the precision of data that is allowed in this property. For example, if the property is a Decimal then this is the maximum number of digits. (Inherited from IReadOnlyProperty)
GetPrincipals()	Finds the list of principal properties including the given property that the given property is constrained by if the given property is part of a foreign key.
GetPrincipals<T>()	Finds the list of principal properties including the given property that the given property is constrained by if the given property is part of a foreign key. (Inherited from IReadOnlyProperty)
GetPropertyAccessMode()	Gets the PropertyAccessMode being used for this property-like object. (Inherited from IReadOnlyPropertyBase)
GetProviderClrType()	Gets the type that the property value will be converted to before being sent to the database provider. (Inherited from IReadOnlyProperty)
GetProviderValueComparer()	Gets the ValueComparer to use for the provider values for this property.
GetRuntimeAnnotations()	Gets all the runtime annotations on the current object. (Inherited from IAnnotatable)
GetScale()	Gets the scale of data that is allowed in this property. For example, if the property is a Decimal then this is the maximum number of decimal places. (Inherited from IReadOnlyProperty)
GetTypeMapping()	Returns the CoreTypeMapping for the given property from a finalized model. (Inherited from IReadOnlyProperty)
GetValueComparer()	Gets the ValueComparer for this property.
GetValueConverter()	Gets the custom ValueConverter set for this property. (Inherited from IReadOnlyProperty)
GetValueGeneratorFactory()	Gets the factory that has been set to generate values for this property, if any. (Inherited from IReadOnlyProperty)
IsForeignKey()	Gets a value indicating whether this property is used as a foreign key (or part of a composite foreign key). (Inherited from IReadOnlyProperty)
IsIndex()	Gets a value indicating whether this property is used as an index (or part of a composite index). (Inherited from IReadOnlyProperty)
IsIndexerProperty()	Gets a value indicating whether this is an indexer property. An indexer property is one that is accessed through an indexer on the entity class. (Inherited from IReadOnlyPropertyBase)
IsKey()	Gets a value indicating whether this property is used as the primary key or alternate key (or part of a composite primary or alternate key). (Inherited from IReadOnlyProperty)
IsPrimaryKey()	Gets a value indicating whether this property is used as the primary key (or part of a composite primary key). (Inherited from IReadOnlyProperty)
IsUnicode()	Gets a value indicating whether or not the property can persist Unicode characters. (Inherited from IReadOnlyProperty)
IsUniqueIndex()	Gets a value indicating whether this property is used as a unique index (or part of a unique composite index). (Inherited from IReadOnlyProperty)
RemoveRuntimeAnnotation(String)	Removes the given runtime annotation from this object. (Inherited from IAnnotatable)
SetRuntimeAnnotation(String, Object)	Sets the runtime annotation stored under the given key. Overwrites the existing annotation if an annotation with the specified name already exists. (Inherited from IAnnotatable)
ToDebugString(MetadataDebugStringOptions, Int32)	Creates a human-readable representation of the given metadata. Warning: Do not rely on the format of the returned string. It is designed for debugging only and may change arbitrarily between releases. (Inherited from IReadOnlyProperty)

Extension Methods

GetJsonPropertyName(IReadOnlyProperty)	Returns the property name that the property is mapped to when targeting Cosmos.
GetVectorType(IReadOnlyProperty)	Returns the definition of the vector stored in this property.
FindColumn(IProperty, StoreObjectIdentifier)	Returns the column corresponding to this property if it's mapped to the given table-like store object.
FindOverrides(IProperty, StoreObjectIdentifier)	Returns the property facet overrides for a particular table-like store object. This method is typically used by database providers (and other extensions). It is generally not used in application code.
FindOverrides(IReadOnlyProperty, StoreObjectIdentifier)	Returns the property facet overrides for a particular table-like store object. This method is typically used by database providers (and other extensions). It is generally not used in application code.
FindRelationalTypeMapping(IReadOnlyProperty, StoreObjectIdentifier)	Returns the RelationalTypeMapping for the given property on a finalized model.
FindRelationalTypeMapping(IReadOnlyProperty)	Returns the RelationalTypeMapping for the given property on a finalized model.
FindSharedStoreObjectRootProperty(IProperty, StoreObjectIdentifier)	Finds the first IProperty that is mapped to the same column in a shared table-like object. This method is typically used by database providers (and other extensions). It is generally not used in application code.
FindSharedStoreObjectRootProperty(IReadOnlyProperty, StoreObjectIdentifier)	Finds the first IProperty that is mapped to the same column in a shared table-like object. This method is typically used by database providers (and other extensions). It is generally not used in application code.
GetCollation(IReadOnlyProperty, StoreObjectIdentifier)	Returns the collation to be used for the column.
GetCollation(IReadOnlyProperty)	Returns the collation to be used for the column.
GetColumnBaseName(IReadOnlyProperty)	Obsolete. Returns the base name of the column to which the property would be mapped.
GetColumnName(IReadOnlyProperty, StoreObjectIdentifier)	Returns the name of the column to which the property is mapped for a particular table.
GetColumnName(IReadOnlyProperty)	Returns the name of the column to which the property would be mapped.
GetColumnOrder(IReadOnlyProperty, StoreObjectIdentifier)	Returns the order of the column this property is mapped to for a particular table.
GetColumnOrder(IReadOnlyProperty)	Returns the order of the column this property is mapped to.
GetColumnType(IProperty, StoreObjectIdentifier)	Returns the database type of the column to which the property is mapped.
GetColumnType(IProperty)	Returns the database type of the column to which the property is mapped.
GetColumnType(IReadOnlyProperty, StoreObjectIdentifier)	Returns the database type of the column to which the property is mapped, or null if the database type could not be found.
GetColumnType(IReadOnlyProperty)	Returns the database type of the column to which the property is mapped, or null if the database type could not be found.
GetComment(IReadOnlyProperty, StoreObjectIdentifier)	Returns the comment for the column this property is mapped to.
GetComment(IReadOnlyProperty)	Returns the comment for the column this property is mapped to.
GetComputedColumnSql(IReadOnlyProperty, StoreObjectIdentifier)	Returns the SQL expression that is used as the computed value for the column this property is mapped to.
GetComputedColumnSql(IReadOnlyProperty)	Returns the SQL expression that is used as the computed value for the column this property is mapped to.
GetDefaultColumnBaseName(IReadOnlyProperty)	Obsolete. Returns the default base name of the column to which the property would be mapped
GetDefaultColumnMappings(IProperty)	Returns the default columns to which the property would be mapped.
GetDefaultColumnName(IReadOnlyProperty, StoreObjectIdentifier)	Returns the default column name to which the property would be mapped.
GetDefaultColumnName(IReadOnlyProperty)	Returns the default base name of the column to which the property would be mapped
GetDefaultValue(IReadOnlyProperty, StoreObjectIdentifier)	Returns the object that is used as the default value for the column this property is mapped to.
GetDefaultValue(IReadOnlyProperty)	Returns the object that is used as the default value for the column this property is mapped to.
GetDefaultValueSql(IReadOnlyProperty, StoreObjectIdentifier)	Returns the SQL expression that is used as the default value for the column this property is mapped to.
GetDefaultValueSql(IReadOnlyProperty)	Returns the SQL expression that is used as the default value for the column this property is mapped to.
GetDeleteStoredProcedureParameterMappings(IProperty)	Returns the delete stored procedure parameters to which the property is mapped.
GetFunctionColumnMappings(IProperty)	Returns the function columns to which the property is mapped.
GetInsertStoredProcedureParameterMappings(IProperty)	Returns the insert stored procedure parameters to which the property is mapped.
GetInsertStoredProcedureResultColumnMappings(IProperty)	Returns the insert stored procedure result columns to which the property is mapped.
GetIsStored(IReadOnlyProperty, StoreObjectIdentifier)	Gets whether the value of the computed column this property is mapped to is stored in the database, or calculated when it is read.
GetIsStored(IReadOnlyProperty)	Gets whether the value of the computed column this property is mapped to is stored in the database, or calculated when it is read.
GetJsonPropertyName(IReadOnlyProperty)	Gets the value of JSON property name used for the given property of an entity mapped to a JSON column.
GetMappedStoreObjects(IReadOnlyProperty, StoreObjectType)	Returns the table-like store objects to which this property is mapped. This method is typically used by database providers (and other extensions). It is generally not used in application code.
GetMaxLength(IReadOnlyProperty, StoreObjectIdentifier)	Gets the maximum length of data that is allowed in this property. For example, if the property is a String then this is the maximum number of characters.
GetOverrides(IProperty)	Returns all the property facet overrides. This method is typically used by database providers (and other extensions). It is generally not used in application code.
GetOverrides(IReadOnlyProperty)	Returns all the property facet overrides. This method is typically used by database providers (and other extensions). It is generally not used in application code.
GetPrecision(IReadOnlyProperty, StoreObjectIdentifier)	Gets the precision of data that is allowed in this property. For example, if the property is a Decimal then this is the maximum number of digits.
GetReaderFieldValue(IProperty, RelationalDataReader, Int32, Boolean)	Reads a value for this property from the given relationalReader.
GetRelationalTypeMapping(IReadOnlyProperty)	Returns the RelationalTypeMapping for the given property on a finalized model.
GetScale(IReadOnlyProperty, StoreObjectIdentifier)	Gets the scale of data that is allowed in this property. For example, if the property is a Decimal then this is the maximum number of decimal places.
GetSqlQueryColumnMappings(IProperty)	Returns the SQL query columns to which the property is mapped.
GetTableColumnMappings(IProperty)	Returns the table columns to which the property is mapped.
GetUpdateStoredProcedureParameterMappings(IProperty)	Returns the update stored procedure parameters to which the property is mapped.
GetUpdateStoredProcedureResultColumnMappings(IProperty)	Returns the update stored procedure result columns to which the property is mapped.
GetViewColumnMappings(IProperty)	Returns the view columns to which the property is mapped.
IsColumnNullable(IReadOnlyProperty, StoreObjectIdentifier)	Checks whether the column mapped to the given property will be nullable when created in the database.
IsColumnNullable(IReadOnlyProperty)	Checks whether the column mapped to the given IProperty will be nullable when created in the database.
IsFixedLength(IReadOnlyProperty, StoreObjectIdentifier)	Returns a flag indicating whether the property is capable of storing only fixed-length data, such as strings.
IsFixedLength(IReadOnlyProperty)	Returns a flag indicating whether the property is capable of storing only fixed-length data, such as strings.
IsUnicode(IReadOnlyProperty, StoreObjectIdentifier)	Gets a value indicating whether or not the property can persist Unicode characters.
TryGetDefaultValue(IReadOnlyProperty, StoreObjectIdentifier, Object)	Returns the object that is used as the default value for the column this property is mapped to.
TryGetDefaultValue(IReadOnlyProperty, Object)	Returns the object that is used as the default value for the column this property is mapped to.
GetDataAnnotations(IProperty, IAnnotationCodeGenerator)	Gets the data annotations to configure a property.
GetFluentApiCalls(IProperty, IAnnotationCodeGenerator)	Gets the fluent API calls to configure a property.
GetSrid(IReadOnlyProperty, StoreObjectIdentifier)	Returns the SRID to use when creating a column for this property.
GetSrid(IReadOnlyProperty)	Returns the SRID to use when creating a column for this property.
FindHiLoSequence(IProperty, StoreObjectIdentifier)	Finds the ISequence in the model to use for the hi-lo pattern.
FindHiLoSequence(IProperty)	Finds the ISequence in the model to use for the hi-lo pattern.
FindHiLoSequence(IReadOnlyProperty, StoreObjectIdentifier)	Finds the ISequence in the model to use for the hi-lo pattern.
FindHiLoSequence(IReadOnlyProperty)	Finds the ISequence in the model to use for the hi-lo pattern.
FindSequence(IProperty, StoreObjectIdentifier)	Finds the ISequence in the model to use for the key value generation pattern.
FindSequence(IProperty)	Finds the ISequence in the model to use for the key value generation pattern.
FindSequence(IReadOnlyProperty, StoreObjectIdentifier)	Finds the ISequence in the model to use for the key value generation pattern.
FindSequence(IReadOnlyProperty)	Finds the ISequence in the model to use for the key value generation pattern.
GetHiLoSequenceName(IReadOnlyProperty, StoreObjectIdentifier)	Returns the name to use for the hi-lo sequence.
GetHiLoSequenceName(IReadOnlyProperty)	Returns the name to use for the hi-lo sequence.
GetHiLoSequenceSchema(IReadOnlyProperty, StoreObjectIdentifier)	Returns the schema to use for the hi-lo sequence.
GetHiLoSequenceSchema(IReadOnlyProperty)	Returns the schema to use for the hi-lo sequence.
GetIdentityIncrement(IReadOnlyProperty, StoreObjectIdentifier)	Returns the identity increment.
GetIdentityIncrement(IReadOnlyProperty)	Returns the identity increment.
GetIdentitySeed(IReadOnlyProperty, StoreObjectIdentifier)	Returns the identity seed.
GetIdentitySeed(IReadOnlyProperty)	Returns the identity seed.
GetSequenceName(IReadOnlyProperty, StoreObjectIdentifier)	Returns the name to use for the key value generation sequence.
GetSequenceName(IReadOnlyProperty)	Returns the name to use for the key value generation sequence.
GetSequenceSchema(IReadOnlyProperty, StoreObjectIdentifier)	Returns the schema to use for the key value generation sequence.
GetSequenceSchema(IReadOnlyProperty)	Returns the schema to use for the key value generation sequence.
GetValueGenerationStrategy(IReadOnlyProperty, StoreObjectIdentifier)	Returns the SqlServerValueGenerationStrategy to use for the property.
GetValueGenerationStrategy(IReadOnlyProperty)	Returns the SqlServerValueGenerationStrategy to use for the property.
IsSparse(IReadOnlyProperty, StoreObjectIdentifier)	Returns a value indicating whether the property's column is sparse.
IsSparse(IReadOnlyProperty)	Returns a value indicating whether the property's column is sparse.