| Revit 2015 API |
| Document..::..NewPipe Method (XYZ, Connector, PipeType) |
| Document Class See Also |
Adds a new pipe into the document,
using a point, connector and pipe type.
Namespace: Autodesk.Revit.Creation
Assembly: RevitAPI (in RevitAPI.dll) Version: 2015.0.0.0 (2015.0.0.0)
Syntax
| C# |
|---|
[ObsoleteAttribute("This method is obsolete in Revit 2015. Please use Pipe.Create() instead.")] public Pipe NewPipe( XYZ point, Connector connector, PipeType pipeType ) |
| Visual Basic |
|---|
<ObsoleteAttribute("This method is obsolete in Revit 2015. Please use Pipe.Create() instead.")> _ Public Function NewPipe ( _ point As XYZ, _ connector As Connector, _ pipeType As PipeType _ ) As Pipe |
| Visual C++ |
|---|
[ObsoleteAttribute(L"This method is obsolete in Revit 2015. Please use Pipe.Create() instead.")] public: Pipe^ NewPipe( XYZ^ point, Connector^ connector, PipeType^ pipeType ) |
Parameters
- point
- Type: Autodesk.Revit.DB..::..XYZ
The first point of the pipe.
- connector
- Type: Autodesk.Revit.DB..::..Connector
The connector to be connected to the pipe.
- pipeType
- Type: Autodesk.Revit.DB.Plumbing..::..PipeType
The type of the pipe.
Return Value
If creation was successful then a new pipe is returned, otherwise an exception with failure information will be thrown.
Remarks
If the connector is a fitting or equipment connector of the correct domain,
and if the connector's direction matches the direction of the pipe to be created,
the connectors will be automatically connected. A transition fitting will be added
at the connector if necessary. If the connector's type, domain, or direction
does not match the direction of the duct to be created, the position of the input connector
will govern the endpoints of the pipe, but no connection will be established.
Exceptions
| Exception | Condition |
|---|---|
| Autodesk.Revit.Exceptions..::..ArgumentNullException | Thrown when the input argument point or connector is nullNothingnullptra null reference (Nothing in Visual Basic). |
| Autodesk.Revit.Exceptions..::..InvalidOperationException | Thrown when the pipe cannot be created or regenerate fails. |