Write(Object,String) Method

In This Topic

Write sampled metric samples for all sampled metrics defined on the provided data object by attributes.

Syntax

Visual Basic
C#

'Declaration
 
Public Overloads Shared Sub Write( _
   ByVal metricData As Object, _
   ByVal fallbackInstanceName As String _
)

public static void Write( 
   object metricData,
   string fallbackInstanceName
)

Parameters

metricData: The object to retrieve both metric values and definition from
fallbackInstanceName: The instance name to fall back on if a definition does not specify an instance name binding (may be null).

Exceptions

Exception	Description
System.ArgumentNullException	The provided metricData object was null.
System.ArgumentException	The specified Type does not have a SampledMetric attribute, so it can't be used to define sampled metrics. - or - The specified Type does not have a usable SampledMetric attribute, so it can't be used to define sampled metrics. - or - The specified Type's SampledMetric attribute has an empty metric namespace which is not allowed, so no metrics can be defined under it. - or - The specified Type's SampledMetric attribute has an empty metric category name which is not allowed, so no metrics can be defined under it.

Exception

Description

System.ArgumentNullException

The provided metricData object was null.

System.ArgumentException

The specified Type does not have a SampledMetric attribute, so it can't be used to define sampled metrics.
- or -
The specified Type does not have a usable SampledMetric attribute, so it can't be used to define sampled metrics.
- or -
The specified Type's SampledMetric attribute has an empty metric namespace which is not allowed, so no metrics can be defined under it.
- or -
The specified Type's SampledMetric attribute has an empty metric category name which is not allowed, so no metrics can be defined under it.

Remarks

The provided user data object must be assignable to the bound type which defined this sampled metric via attributes.

Example

For examples, see the Sampled Metric class overview.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

SampledMetric Class
SampledMetric Members
Overload List

Send Feedback