Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

AF SDK Reference

AFAdjustments Class

  • Last UpdatedNov 18, 2025
  • 9 minute read
AFAdjustments Class
This is a collection of AFAdjustment objects made to an AFAttribute value used during the run of a case.

Inheritance Hierarchy

SystemObject
  OSIsoft.AFAFCollection
    OSIsoft.AFAFCollectionAFAdjustment
      OSIsoft.AF.AnalysisAFAdjustments

Namespace:  OSIsoft.AF.Analysis
Assembly:  OSIsoft.AFSDK (in OSIsoft.AFSDK.dll) Version: 3.1.1.1182

Syntax

public sealed class AFAdjustments : AFCollection<AFAdjustment>
Public NotInheritable Class AFAdjustments
	Inherits AFCollection(Of AFAdjustment)

Dim instance As AFAdjustments
public ref class AFAdjustments sealed : public AFCollection<AFAdjustment^>
[<SealedAttribute>]
type AFAdjustments =  
    class
        inherit AFCollection<AFAdjustment>
    end

The AFAdjustments type exposes the following members.

Properties

  NameDescription
Public property
Case
This property returns the AFCase object which contains the adjustment.
Public property
Count
Gets the number of items actually contained in the collection.
(Inherited from AFCollectionT.)
Public property
Database
This read-only property returns the AFDatabase where this object is defined.
Public property
Identity
This read-only property contains identity of the object.
(Inherited from AFCollection.)
Public property
IsDeleted
This read-only property indicates whether the owner of the collection has been deleted.
(Inherited from AFCollection.)
Public property
ItemGuid
Returns the item in the collection associated with the passed in ID.
(Inherited from AFCollectionT.)
Public property
ItemInt32
Returns the item located at the passed in index.
(Inherited from AFCollectionT.)
Public property
ItemIdentity
This read-only property specifies the identity of the objects within the collection.
(Inherited from AFCollection.)
Public property
PISystem
This read-only property allows access to the PISystem associated with this collection.
(Inherited from AFCollection.)
Public property
Result
This property returns the AFResult object which owns the adjustment.

Methods

  NameDescription
Public method
Add(T)
Adds an object to the end of the collection.
(Inherited from AFCollectionT.)
Public method
Add(String, String, Object, UOM)
The Add method creates a new adjustment to the value of an attribute within the context of an AFCase object and adds the adjustment to the collection.
Public method
Clear
Removes all items from the collection.
(Inherited from AFCollectionT.)
Public method
Clear(String, String)
The Clear method does not delete any previous adjustments to the value of an attribute, it clears the adjustment so that it does not have any effect on the attribute value.
Public method
Contains(Guid)
This method determines whether the collection contains a specific item referenced by id.
(Inherited from AFCollectionT.)
Public method
Contains(T)
This method determines whether the collection contains a specific item.
(Inherited from AFCollectionT.)
Public method
CopyTo
Copies the entire collection to a compatible one-dimensional Array, starting at the specified index of the target array.
(Inherited from AFCollectionT.)
Public method
Equals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Public method
GetEnumerator
Returns an enumerator that iterates through the collection.
(Inherited from AFCollectionT.)
Public method
GetHashCode
Gets the hash code for this instance of the object which is suitable for use in hashing algorithms and data structures like a hash table.
(Inherited from AFCollection.)
Public method
GetType
Gets the Type of the current instance.
(Inherited from Object.)
Public method
IndexOf
Searches for the specified object and returns the zero-based index of the first occurrence within the entire collection.
(Inherited from AFCollectionT.)
Public method
Remove(Guid)
Removes the item with the specified id from the collection.
(Inherited from AFCollectionT.)
Public method
Remove(T)
Removes the first occurrence of a specific object from the collection.
(Inherited from AFCollectionT.)
Public method
RemoveAt
Removes the item at the specified index of the collection.
(Inherited from AFCollectionT.)
Public method
Sort
Sorts the items in the entire collection using the default comparer.
(Inherited from AFCollectionT.)
Public method
Sort(IComparerT)
Sorts the items in the entire collection using the specified comparer.
(Inherited from AFCollectionT.)
Public method
Sort(Int32, Int32, IComparerT)
Sorts the items in a range of items in the collection using the specified comparer.
(Inherited from AFCollectionT.)
Public method
ToString
Returns a String that represents the current object.
(Inherited from AFCollection.)

Remarks

This collection is maintained by the AFCase. Use the Add(String, String, Object, UOM) method to add a new adjustment to the collection. Adjustments affect the value returned from the AFAttribute.GetValue Overload methods when called with the AFCase object as a context.

Examples

// This example shows how to create an adjustment to an attribute value made during a case run.
// Note: This example assumes that there is a database called "Chocolate Milk Tutorial"
// with a Model named "ChocolateMilkModel", with a Model Analysis named "Volume Balance"
// The model also contains a "MilkTank1" child Element with a "Volume" Attribute

// Get the Database
PISystems myPISystems = new PISystems();
AFDatabase myDB = myPISystems.DefaultPISystem.Databases["Chocolate Milk Tutorial"];

// Get the Model Analysis
AFAnalysis myAnalysis = AFAnalysis.FindAnalyses(myDB, "ChocolateMilkModel::Volume Balance",
    AFSearchField.Name, AFSortField.Name, AFSortOrder.Ascending, 1)[0];

// Create a Case and Collect Inputs
AFCase myCase = myAnalysis.AddCase();
myCase.CollectInputs();

// Create an Adjustment
AFResult myResult = myCase.Results[myDB.Elements["MilkTank1"].Attributes["Volume"]];
myResult.Adjustments.Add("This is the creator.", "This is a comment.", "2 US gal", null);
myDB.CheckIn();

// Display each Adjustment before clear method
Console.WriteLine("Adjustment Count = {0}", myResult.Adjustments.Count);
foreach (AFAdjustment CurAdjustment in myResult.Adjustments)
{
    Console.WriteLine("Before Clear Method:");
    AFElement ownerElement = CurAdjustment.Attribute.Element as AFElement;
    if (ownerElement != null)
        Console.WriteLine("  Element of Adjustment = {0}", ownerElement.Name);
    Console.WriteLine("  Attribute of Element Adjusted = {0}", CurAdjustment.Attribute.Name);
    Console.WriteLine("  Adjusted Value = {0}", CurAdjustment.AdjustedValue);
    Console.WriteLine("  Previous Value = {0}", CurAdjustment.PreviousValue);
}

// Call the clear method on the collection to clear the non-committed Adjustment values
myResult.Adjustments.Clear("This is the creator.", "This is the comment.");

// Display each Adjustment after clear method
Console.WriteLine("Adjustment Count = {0}", myResult.Adjustments.Count);
foreach (AFAdjustment CurAdjustment in myResult.Adjustments)
{
    Console.WriteLine("After Clear Method:");
    Console.WriteLine("  Element of Adjustment = {0}", CurAdjustment.Attribute.Element.Name);
    Console.WriteLine("  Attribute of Element Adjusted = {0}", CurAdjustment.Attribute.Name);
    if (CurAdjustment.AdjustedValue == null)
        Console.WriteLine("  Adjusted Value = <null>");
    else
        Console.WriteLine("  Adjusted Value = {0}", CurAdjustment.AdjustedValue);
    if (CurAdjustment.PreviousValue == null)
        Console.WriteLine("  Previous Value = <null>");
    else
        Console.WriteLine("  Previous Value = {0}", CurAdjustment.PreviousValue);
}
' This example shows how to create an adjustment to an attribute value made during a case run.
' Note: This example assumes that there is a database called "Chocolate Milk Tutorial"
' with a Model named "ChocolateMilkModel", with a Model Analysis named "Volume Balance"
' The model also contains a "MilkTank1" child Element with a "Volume" Attribute

' Get the Database
Dim myPISystems As New PISystems
Dim myDB As AFDatabase = myPISystems.DefaultPISystem.Databases("Chocolate Milk Tutorial")

' Get the Model Analysis
Dim myAnalysis As AFAnalysis = AFAnalysis.FindAnalyses(myDB, "ChocolateMilkModel::Volume Balance",
    AFSearchField.Name, AFSortField.Name, AFSortOrder.Descending, 1)(0)

' Create a Case and Collect Inputs
Dim myCase As AFCase = myAnalysis.AddCase
myCase.CollectInputs()

' Create an Adjustment
Dim myResult As AFResult = myCase.Results(myDB.Elements("MilkTank1").Attributes("Volume"))
Dim CurAdjustment As AFAdjustment = myResult.Adjustments.Add("This is the creator.",
    "This is a comment.", "2 US gal", Nothing)
myDB.CheckIn()

' Display each Adjustment before clear method
Console.WriteLine("Adjustment Count = {0}", myResult.Adjustments.Count)
For Each CurAdjustment In myResult.Adjustments
    Console.WriteLine("Before Clear Method:")
    Dim ownerElement As AFElement = CType(CurAdjustment.Attribute.Element, AFElement)
    If (ownerElement <> Nothing) Then
        Console.WriteLine("  Element of Adjustment = {0}", ownerElement.Name)
    End If
    Console.WriteLine("  Attribute of Element Adjusted = {0}", CurAdjustment.Attribute.Name)
    Console.WriteLine("  Adjusted Value = {0}", CurAdjustment.AdjustedValue)
    Console.WriteLine("  Previous Value = {0}", CurAdjustment.PreviousValue)
Next CurAdjustment

' Call the clear method on the collection to clear the non-committed Adjustment values
myResult.Adjustments.Clear("This is the creator.", "This is the comment.")

' Display each Adjustment after clear method
Console.WriteLine("Adjustment Count = {0}", myResult.Adjustments.Count)
For Each CurAdjustment In myResult.Adjustments
    Console.WriteLine("After Clear Method:")
    Console.WriteLine("  Element of Adjustment = {0}", CurAdjustment.Attribute.Element.Name)
    Console.WriteLine("  Attribute of Element Adjusted = {0}", CurAdjustment.Attribute.Name)
    If CurAdjustment.AdjustedValue Is Nothing Then
        Console.WriteLine("  Adjusted Value = <null>")
    Else
        Console.WriteLine("  Adjusted Value = {0}", CurAdjustment.AdjustedValue)
    End If
    If CurAdjustment.PreviousValue Is Nothing Then
        Console.WriteLine("  Previous Value = <null>")
    Else
        Console.WriteLine("  Previous Value = {0}", CurAdjustment.PreviousValue)
    End If
Next CurAdjustment

No code example is currently available or this language may not be supported.

No code example is currently available or this language may not be supported.

Version Information

AFSDK


See Also

TitleResults for “How to create a CRG?”Also Available in