public AFValues RecordedValues( AFTimeRange timeRange, AFBoundaryType boundaryType, string filterExpression, bool includeFilteredValues, int maxCount = 0 )
Public Function RecordedValues ( timeRange As AFTimeRange, boundaryType As AFBoundaryType, filterExpression As String, includeFilteredValues As Boolean, Optional maxCount As Integer = 0 ) As AFValues Dim instance As PIPoint Dim timeRange As AFTimeRange Dim boundaryType As AFBoundaryType Dim filterExpression As String Dim includeFilteredValues As Boolean Dim maxCount As Integer Dim returnValue As AFValues returnValue = instance.RecordedValues(timeRange, boundaryType, filterExpression, includeFilteredValues, maxCount)
public: AFValues^ RecordedValues( AFTimeRange timeRange, AFBoundaryType boundaryType, String^ filterExpression, bool includeFilteredValues, int maxCount = 0 )
member RecordedValues : timeRange : AFTimeRange * boundaryType : AFBoundaryType * filterExpression : string * includeFilteredValues : bool * ?maxCount : int (* Defaults: let _maxCount = defaultArg maxCount 0 *) -> AFValues
Returned times are affected by the specified boundaryType. If no values are found for the time range and conditions specified then the method will return success and an empty AFValues collection.
When specifying for the includeFilteredValues parameter, consecutive filtered events are not returned. The first value that would be filtered out is returned with its time and the enumeration value "Filtered". The next value in the collection will be the next compressed value in the specified direction that passes the filter criteria - if any.
When both boundaryType and a filterExpression are specified, the events returned for the boundary condition specified are passed through the filter. If the includeFilteredValues parameter is , the boundary values will be reported at the proper time stamps with the enumeration value "Filtered" when the filter conditions are not met at the boundary time. If the includeFilteredValues parameter is for this case, no event is returned for the boundary time.
The PI Data Archive imposes a limit on the maximum number of events that can be returned with a single call. As of PI 3.4.380, the default is set at 1.5M. This behavior can be changed on the server by editing the server's PITimeout table and adding or editing the value associated with the parameter ArcMaxCollect.
When a PI Point is queried over a time range which includes the current source server time, where the latest known value is before the server current time, a manufactured event containing an Enumeration Value with the bad value NoData, will be placed in the results at a time stamp one second past the current server time for boundary types Interpolated and Outside. This is provided to assist the caller in further interpolation of the results. Specifying a boundary type of Inside indicates that no interpolation is desired and this manufactured value is not provided for that case. The NoData will be reflected into any dependent calculation based Data References.
|Notes to Callers|
|This method, property, or class is only available in the .NET 4 version of the SDK.|