FeatureSupport.GetVersionPresent Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets the version of the specified feature that is available on the system.
Overloads
GetVersionPresent(Object) |
When overridden in a derived class, gets the version of the specified feature that is available on the system. |
GetVersionPresent(String, String) |
Gets the version of the specified feature that is available on the system. |
GetVersionPresent(Object)
When overridden in a derived class, gets the version of the specified feature that is available on the system.
public:
abstract Version ^ GetVersionPresent(System::Object ^ feature);
public abstract Version GetVersionPresent (object feature);
public abstract Version? GetVersionPresent (object feature);
abstract member GetVersionPresent : obj -> Version
Public MustOverride Function GetVersionPresent (feature As Object) As Version
Parameters
- feature
- Object
The feature whose version is requested.
Returns
A Version representing the version number of the specified feature available on the system; or null
if the feature is not installed.
Implements
Examples
The following code example uses the OSFeature implementation of FeatureSupport and queries for the LayeredWindows feature. The version is checked to see if it is null
, to determine whether the feature is present. The result is displayed in a text box. This code requires that textBox1
has been created and placed on a form.
private:
void LayeredWindows()
{
// Gets the version of the layered windows feature.
Version^ myVersion = OSFeature::Feature->GetVersionPresent(
OSFeature::LayeredWindows );
// Prints whether the feature is available.
if ( myVersion != nullptr )
{
textBox1->Text = "Layered windows feature is installed.\n";
}
else
{
textBox1->Text = "Layered windows feature is not installed.\n";
}
// This is an alternate way to check whether a feature is present.
if ( OSFeature::Feature->IsPresent( OSFeature::LayeredWindows ) )
{
textBox1->Text = String::Concat( textBox1->Text,
"Again, layered windows feature is installed." );
}
else
{
textBox1->Text = String::Concat( textBox1->Text,
"Again, layered windows feature is not installed." );
}
}
private void LayeredWindows() {
// Gets the version of the layered windows feature.
Version myVersion = OSFeature.Feature.GetVersionPresent(OSFeature.LayeredWindows);
// Prints whether the feature is available.
if (myVersion != null)
textBox1.Text = "Layered windows feature is installed." + '\n';
else
textBox1.Text = "Layered windows feature is not installed." + '\n';
// This is an alternate way to check whether a feature is present.
if (OSFeature.Feature.IsPresent(OSFeature.LayeredWindows))
textBox1.Text += "Again, layered windows feature is installed.";
else
textBox1.Text += "Again, layered windows feature is not installed.";
}
Private Sub LayeredWindows()
' Gets the version of the layered windows feature.
Dim myVersion As Version = _
OSFeature.Feature.GetVersionPresent(OSFeature.LayeredWindows)
' Prints whether the feature is available.
If (myVersion IsNot Nothing) Then
textBox1.Text = "Layered windows feature is installed." & _
ControlChars.CrLf
Else
textBox1.Text = "Layered windows feature is not installed." & _
ControlChars.CrLf
End If
'This is an alternate way to check whether a feature is present.
If OSFeature.Feature.IsPresent(OSFeature.LayeredWindows) Then
textBox1.Text &= "Again, layered windows feature is installed."
Else
textBox1.Text &= "Again, layered windows feature is not installed."
End If
End Sub
Remarks
Version numbers consist of three parts: major, minor, and build. Typically, a version number is displayed as "major number.minor number.build number".
Notes to Implementers
When you inherit from FeatureSupport, you must override this method. When you override this method, check that the class that you use for the feature
parameter is the same as the class used for this parameter in the IsPresent(String, String) method. If the two feature
parameters differ, you must also override IsPresent(String, String).
See GetVersionPresent(Object) for an implementation of this method.
See also
Applies to
GetVersionPresent(String, String)
Gets the version of the specified feature that is available on the system.
public:
static Version ^ GetVersionPresent(System::String ^ featureClassName, System::String ^ featureConstName);
public static Version GetVersionPresent (string featureClassName, string featureConstName);
public static Version? GetVersionPresent (string featureClassName, string featureConstName);
static member GetVersionPresent : string * string -> Version
Public Shared Function GetVersionPresent (featureClassName As String, featureConstName As String) As Version
Parameters
- featureClassName
- String
The fully qualified name of the class to query for information about the specified feature. This class must implement the IFeatureSupport interface or inherit from a class that implements this interface.
- featureConstName
- String
The fully qualified name of the feature to look for.
Returns
A Version with the version number of the specified feature available on the system; or null
if the feature is not installed.
Remarks
Version numbers consist of three parts: major, minor, and build. Typically, a version number is displayed as "major number.minor number.build number".
See the documentation for the product containing the feature to determine the names to pass to the featureClassName
and the featureConstName
parameters.