Share via


ElementLocation Class

The location of an XML node in a file.

Any editing of the project XML through the MSBuild API's will invalidate locations in that XML until the XML is reloaded.

MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.

Inheritance Hierarchy

System.Object
  Microsoft.Build.Construction.ElementLocation

Namespace:  Microsoft.Build.Construction
Assembly:  Microsoft.Build (in Microsoft.Build.dll)

Syntax

'Declaration
<SerializableAttribute> _
Public MustInherit Class ElementLocation
[SerializableAttribute]
public abstract class ElementLocation
[SerializableAttribute]
public ref class ElementLocation abstract
[<AbstractClass>]
[<SerializableAttribute>]
type ElementLocation =  class end
public abstract class ElementLocation

The ElementLocation type exposes the following members.

Constructors

  Name Description
Protected method ElementLocation Initializes a new instance of the ElementLocation class.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.

Top

Properties

  Name Description
Public property Column The column number where this element exists in its file. The first column is numbered 1. Zero indicates "unknown location".MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.
Public property File The file from which this particular element originated. It may differ from the ProjectFile if, for instance, it was part of an import or originated in a targets file. If not known, returns empty string.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.
Public property Line The line number where this element exists in its file. The first line is numbered 1. Zero indicates "unknown location".MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.
Public property LocationString The location in a form suitable for replacement into a message. Example: "c:\dir\proj.csproj (12,34)" Calling this creates and formats a new string. Only in rare cases should the location go within the message itself.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.

Top

Methods

  Name Description
Public method Equals Override Equals so that identical fields imply equal objects.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Overrides Object.Equals(Object).)
Protected method Finalize (Inherited from Object.)
Public method GetHashCode Get reasonable hash code.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Overrides Object.GetHashCode().)
Public method GetType (Inherited from Object.)
Protected method MemberwiseClone (Inherited from Object.)
Public method ToString Location of element.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Overrides Object.ToString().)

Top

Remarks

This object is IMMUTABLE, so that it can be passed around arbitrarily.

DO NOT make these objects any larger. There are huge numbers of them and they are transmitted between nodes.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Microsoft.Build.Construction Namespace