Proprietà

R2026b

Dichiarazione di proprietà, attributi e metodi di accesso

Le proprietà contengono i dati dell’oggetto. Le classi definiscono le stesse proprietà per tutti gli oggetti, ma ogni oggetto può avere valori di dati unici. Gli attributi delle proprietà controllano quali funzioni o metodi possono accedere alla proprietà. È possibile definire funzioni che vengono eseguite ogni volta che vengono impostati o interrogati i valori della proprietà. Le proprietà possono attivare eventi quando il codice accede ai loro valori.

Funzioni

espandi tutto

Informazioni sulle proprietà

`properties`	Class property names
`isprop`	Determine if property is defined by object

Funzioni di validazione

Validazione dell'attributo del valore numerico

`mustBePositive`	Validate that value is positive
`mustBeNonpositive`	Validate that value is nonpositive
`mustBeNonnegative`	Validate that value is nonnegative
`mustBeNegative`	Validate that value is negative
`mustBeFinite`	Validate that value is finite
`mustBeNonNan`	Validate that input does not contain `NaN`
`mustBeNonzero`	Validate that value is nonzero
`mustBeNonsparse`	Validate that value is nonsparse
`mustBeSparse`	Validate that value is sparse (Da R2023b)
`mustBeReal`	Validate that value is real
`mustBeInteger`	Validate that value is integer
`mustBeNonmissing`	Validate that input does not contain missing values

Validazione del confronto

`mustBeGreaterThan`	Validate that value is greater than another value
`mustBeLessThan`	Validate that value is less than another value
`mustBeGreaterThanOrEqual`	Validate that value is greater than or equal to another value
`mustBeLessThanOrEqual`	Validate that value is less than or equal to another value
`mustBeSorted`	Validate that input is sorted (Da R2026a)

Impostazione dell'appartenenza a un insieme e validazione dell'intervallo

`mustBeMember`	Validate that value is member of specified set
`mustBeBetween`	Validate that all elements are within specified range (Da R2025a)

Validazione del tipo di dati

`mustBeA`	Validate that value comes from one of specified classes
`mustBeNumeric`	Validate that value is numeric
`mustBeNumericOrLogical`	Validate that value is numeric or logical
`mustBeFloat`	Validate that value is floating-point array
`mustBeText`	Validate that value is string array, character vector, or cell array of character vectors
`mustBeTextScalar`	Validate that value is single piece of text
`mustBeNonzeroLengthText`	Validate that value is text with nonzero length
`mustBeUnderlyingType`	Validate that value has specified underlying type

Validazione della dimensione

`mustBeNonempty`	Validate that value is nonempty
`mustBeScalar`	Validate that value is scalar (Da R2026b)
`mustBeScalarOrEmpty`	Validate that value is scalar or empty
`mustBeVector`	Validate that value is vector
`mustBeVectorOrEmpty`	Validate that value is vector or empty (Da R2026b)
`mustBeRow`	Validate that value is row vector (Da R2024b)
`mustBeColumn`	Validate that value is column vector (Da R2024b)
`mustBeMatrix`	Validate that value is matrix (Da R2024b)

Testo con validazione del significato specifico

`mustBeFile`	Validate that path refers to file
`mustBeFolder`	Validate that input path refers to folder
`mustBeFilePathInclusive`	Validate that input is file in current folder, specified location, or MATLAB path (Da R2026b)
`mustBeSymbolicLink`	Validate that input is symbolic link (Da R2026b)
`mustBeValidVariableName`	Validate that input name is valid variable name

Classi

`dynamicprops`	Superclass for classes that support dynamic properties
`matlab.metadata.DynamicProperty`	Describe dynamic property of MATLAB object
`event.DynamicPropertyEvent`	Event data for dynamic property events
`matlab.metadata.Property`	Describe property of MATLAB class
`matlab.metadata.PropertyValidation`	Describe property validation
`matlab.metadata.FixedDimension`	Fixed dimension in property size specification
`matlab.metadata.UnrestrictedDimension`	Unrestricted dimension in property size specification
`matlab.metadata.ArrayDimension`	Size information for property validation
`matlab.lang.OnOffSwitchState`	Represent on and off states with logical values

Argomenti

Definizione delle proprietà e impostazione degli attributi

Ways to Use Properties
Class properties can be defined to satisfy different use cases.
Property Syntax
Define class properties using attributes and validators that control behavior.
Property Attributes
Attributes control the behavior of properties.
Mutable and Immutable Properties
You can control what code can set property values.
Initialize Property Values
Classes can assign default values to properties, and you can change these values during object construction.
Define Class Properties with Constant Values
Use a class with Constant properties to define constant values.
Properties Containing Objects
Properties assigned objects as default values construct that object only once when the class is first loaded. Also, assignment to contained object properties behaves differently depending on whether the object is a handle or value.

Validazione delle proprietà

Validate Property Values
You can restrict property values to a size and class, and apply functions to validate assigned values.
Property Class and Size Validation
Define class and size requirements for a property.
Property Validation Functions
Property validation functions enable you to check the values being assigned to properties.
Metadata Interface to Property Validation
Programmatically determine the size, class, and validation functions that validate the values assigned to properties.

Metodi di accesso alle proprietà

Property Get and Set Methods
Property access methods execute code when property values are referenced or assigned.
Get and Set Methods for Dependent Properties
Define get and set access methods for dependent properties.

Proprietà dinamiche

Dynamic Properties — Adding Properties to an Instance
You can add instance data to an object derived from the dynamicprops class.
Set and Get Methods for Dynamic Properties
You can implement what are effectively access methods for dynamic properties.
Dynamic Property Events
You can define listeners for PropertyAdded and PropertyRemoved events on dynamic properties.
Dynamic Properties and ConstructOnLoad
Use the ConstructOnLoad attribute to save and load dynamic properties.