Class SpinWrappedGraph

A simple IGraph implementation that only tracks triple removal and additions

Inheritance
object
SpinWrappedGraph
Implements
Inherited Members
Namespace: VDS.RDF.Query.Spin
Assembly: dotNetRdf.Query.Spin.dll
Syntax
public class SpinWrappedGraph : IGraph, INodeFactory, IDisposable, ITripleIndex, IEquatable<IGraph>

Constructors

| Edit this page View Source

SpinWrappedGraph(IRefNode)

Create a new SPIN graph

Declaration
public SpinWrappedGraph(IRefNode graphName = null)
Parameters
Type Name Description
IRefNode graphName

The graph name. May be null.

Properties

| Edit this page View Source

AllNodes

Gets the unique Subject, Predicate and Object nodes of the asserted triples in the Graph.

Declaration
public IEnumerable<INode> AllNodes { get; }
Property Value
Type Description
IEnumerable<INode>
| Edit this page View Source

AllQuotedNodes

Gets the unique subject, predicate and object nodes of the quoted triples in the graph.

Declaration
public IEnumerable<INode> AllQuotedNodes { get; }
Property Value
Type Description
IEnumerable<INode>
| Edit this page View Source

BaseUri

Get or set the base URI used to resolve relative URI references.

Declaration
public Uri BaseUri { get; set; }
Property Value
Type Description
Uri
| Edit this page View Source

IsEmpty

Gets whether a Graph is Empty.

Declaration
public bool IsEmpty { get; }
Property Value
Type Description
bool
| Edit this page View Source

LanguageTagValidation

Get or set the type of validation to apply to language tags when creating language-tagged literal nodes.

Declaration
public LanguageTagValidationMode LanguageTagValidation { get; set; }
Property Value
Type Description
LanguageTagValidationMode
| Edit this page View Source

Name

Gets the name of the graph.

Declaration
public IRefNode Name { get; }
Property Value
Type Description
IRefNode
Remarks

The graph name May be NULL for an unnamed (default) graph.

| Edit this page View Source

NamespaceMap

Get the namespace map for this node factory.

Declaration
public INamespaceMapper NamespaceMap { get; }
Property Value
Type Description
INamespaceMapper
| Edit this page View Source

Nodes

Gets the unique Subject and Object nodes of the Graph.

Declaration
public IEnumerable<INode> Nodes { get; }
Property Value
Type Description
IEnumerable<INode>
Remarks

This property returns only nodes that appear in the Subject or Object position in asserted triples. To retrieve a list of all INode instances in a graph including those in Predicate position in a triple, use the AllNodes property.

| Edit this page View Source

NormalizeLiteralValues

Get or set the flag that controls whether the value strings of literal nodes should be normalized on creation.

Declaration
public bool NormalizeLiteralValues { get; set; }
Property Value
Type Description
bool
| Edit this page View Source

QuotedNodes

Gets the unique subject and object nodes of the quoted triples in the graph.

Declaration
public IEnumerable<INode> QuotedNodes { get; }
Property Value
Type Description
IEnumerable<INode>
| Edit this page View Source

QuotedTriples

Gets the quoted triples in the graph.

Declaration
public IEnumerable<Triple> QuotedTriples { get; }
Property Value
Type Description
IEnumerable<Triple>
| Edit this page View Source

Triples

Gets the Triple Collection for the Graph.

Declaration
public BaseTripleCollection Triples { get; }
Property Value
Type Description
BaseTripleCollection
| Edit this page View Source

UriFactory

Get or set the factory to use when creating URIs.

Declaration
public IUriFactory UriFactory { get; set; }
Property Value
Type Description
IUriFactory

Methods

| Edit this page View Source

Assert(IEnumerable<Triple>)

Asserts an Enumerable of Triples in the Graph.

Declaration
public bool Assert(IEnumerable<Triple> ts)
Parameters
Type Name Description
IEnumerable<Triple> ts

An Enumerable of Triples.
Returns
Type Description
bool
| Edit this page View Source

Assert(Triple)

Asserts a Triple in the Graph.

Declaration
public bool Assert(Triple t)
Parameters
Type Name Description
Triple t

A Triple.
Returns
Type Description
bool
| Edit this page View Source

Clear()

Retracts all Triples from the Graph.

Declaration
public void Clear()
Remarks

The Graph should raise the ClearRequested event at the start of the Clear operation and abort the operation if the operation is cancelled by an event handler. On completing the Clear the Cleared event should be raised.

| Edit this page View Source

ContainsAssertedTriple(Triple)

Declaration
public bool ContainsAssertedTriple(Triple t)
Parameters
Type Name Description
Triple t
Returns
Type Description
bool
| Edit this page View Source

ContainsQuotedTriple(Triple)

Gets whether a given triple is quoted in this graph.

Declaration
public bool ContainsQuotedTriple(Triple t)
Parameters
Type Name Description
Triple t

Triple to test.
Returns
Type Description
bool

True if the triple is quoted in this graph, false otherwise.
| Edit this page View Source

ContainsTriple(Triple)

Gets whether a given triple is asserted in this Graph.

Declaration
public bool ContainsTriple(Triple t)
Parameters
Type Name Description
Triple t

Triple to test.
Returns
Type Description
bool

True if the triple is asserted in this graph, false otherwise.
| Edit this page View Source

CreateBlankNode()

Creates a Blank Node with a new automatically generated ID.

Declaration
public IBlankNode CreateBlankNode()
Returns
Type Description
IBlankNode
| Edit this page View Source

CreateBlankNode(string)

Creates a Blank Node with the given Node ID.

Declaration
public IBlankNode CreateBlankNode(string nodeId)
Parameters
Type Name Description
string nodeId

Node ID.
Returns
Type Description
IBlankNode
| Edit this page View Source

CreateGraphLiteralNode()

Creates a Graph Literal Node which represents the empty Subgraph.

Declaration
public IGraphLiteralNode CreateGraphLiteralNode()
Returns
Type Description
IGraphLiteralNode
| Edit this page View Source

CreateGraphLiteralNode(IGraph)

Creates a Graph Literal Node which represents the given Subgraph.

Declaration
public IGraphLiteralNode CreateGraphLiteralNode(IGraph subgraph)
Parameters
Type Name Description
IGraph subgraph

Subgraph.
Returns
Type Description
IGraphLiteralNode
| Edit this page View Source

CreateLiteralNode(string)

Creates a Literal Node with the given Value.

Declaration
public ILiteralNode CreateLiteralNode(string literal)
Parameters
Type Name Description
string literal

Value of the Literal.
Returns
Type Description
ILiteralNode
| Edit this page View Source

CreateLiteralNode(string, string)

Creates a Literal Node with the given Value and Language.

Declaration
public ILiteralNode CreateLiteralNode(string literal, string langSpec)
Parameters
Type Name Description
string literal

Value of the Literal.
string langSpec

Language Specifier for the Literal.
Returns
Type Description
ILiteralNode
| Edit this page View Source

CreateLiteralNode(string, Uri)

Creates a Literal Node with the given Value and Data Type.

Declaration
public ILiteralNode CreateLiteralNode(string literal, Uri datatype)
Parameters
Type Name Description
string literal

Value of the Literal.
Uri datatype

Data Type URI of the Literal.
Returns
Type Description
ILiteralNode
| Edit this page View Source

CreateTripleNode(Triple)

Creates a node that quotes the given triple.

Declaration
public ITripleNode CreateTripleNode(Triple triple)
Parameters
Type Name Description
Triple triple

The triple to be the quoted value of the created node.
Returns
Type Description
ITripleNode
| Edit this page View Source

CreateUriNode()

Creates a URI Node that corresponds to the current Base URI of the node factory.

Declaration
public IUriNode CreateUriNode()
Returns
Type Description
IUriNode
| Edit this page View Source

CreateUriNode(string)

Creates a URI Node for the given QName using the Graphs NamespaceMap to resolve the QName.

Declaration
public IUriNode CreateUriNode(string qName)
Parameters
Type Name Description
string qName

QName.
Returns
Type Description
IUriNode
| Edit this page View Source

CreateUriNode(Uri)

Creates a URI Node for the given URI.

Declaration
public IUriNode CreateUriNode(Uri uri)
Parameters
Type Name Description
Uri uri

URI.
Returns
Type Description
IUriNode
| Edit this page View Source

CreateVariableNode(string)

Creates a Variable Node for the given Variable Name.

Declaration
public IVariableNode CreateVariableNode(string varName)
Parameters
Type Name Description
string varName
Returns
Type Description
IVariableNode
| Edit this page View Source

Difference(IGraph)

Calculates the difference between this Graph and the given Graph.

Declaration
public GraphDiffReport Difference(IGraph g)
Parameters
Type Name Description
IGraph g

Graph.
Returns
Type Description
GraphDiffReport
Remarks

Produces a report which shows the changes that must be made to this Graph to produce the given Graph.

| Edit this page View Source

Dispose()

Declaration
public void Dispose()
| Edit this page View Source

Equals(IGraph)

Declaration
public bool Equals(IGraph g)
Parameters
Type Name Description
IGraph g
Returns
Type Description
bool
| Edit this page View Source

Equals(IGraph, out Dictionary<INode, INode>)

Checks whether a Graph is equal to another Graph and if so returns the mapping of Blank Nodes.

Declaration
public bool Equals(IGraph g, out Dictionary<INode, INode> mapping)
Parameters
Type Name Description
IGraph g

Graph to compare with.
Dictionary<INode, INode> mapping

Mapping of Blank Nodes.
Returns
Type Description
bool
| Edit this page View Source

GetBlankNode(string)

Selects the Blank Node with the given ID if it exists in the Graph, returns null otherwise.

Declaration
public IBlankNode GetBlankNode(string nodeId)
Parameters
Type Name Description
string nodeId

Node ID.
Returns
Type Description
IBlankNode

The Node if it exists in the Graph or null.
| Edit this page View Source

GetLiteralNode(string)

Selects the Literal Node with the given Value if it exists in the Graph, returns null otherwise.

Declaration
public ILiteralNode GetLiteralNode(string literal)
Parameters
Type Name Description
string literal

Value of the Literal.
Returns
Type Description
ILiteralNode

The Node if it exists in the Graph or null.
| Edit this page View Source

GetLiteralNode(string, string)

Selects the Literal Node with the given Value and Language if it exists in the Graph, returns null otherwise.

Declaration
public ILiteralNode GetLiteralNode(string literal, string langspec)
Parameters
Type Name Description
string literal

Value of the Literal.
string langspec

Language Specifier of the Literal.
Returns
Type Description
ILiteralNode

The Node if it exists in the Graph or null.
| Edit this page View Source

GetLiteralNode(string, Uri)

Selects the Literal Node with the given Value and DataType if it exists in the Graph, returns otherwise.

Declaration
public ILiteralNode GetLiteralNode(string literal, Uri datatype)
Parameters
Type Name Description
string literal

Value of the Literal.
Uri datatype

Data Type of the Literal.
Returns
Type Description
ILiteralNode

The Node if it exists in the Graph or null.
| Edit this page View Source

GetNextBlankNodeID()

Creates a new unused Blank Node ID and returns it.

Declaration
public string GetNextBlankNodeID()
Returns
Type Description
string
| Edit this page View Source

GetQuoted(Uri)

Selects all quoted triples which have a Uri Node with the given Uri.

Declaration
public IEnumerable<Triple> GetQuoted(Uri uri)
Parameters
Type Name Description
Uri uri

Uri.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetQuoted(INode)

Selects all quoted triples which contain the given Node.

Declaration
public IEnumerable<Triple> GetQuoted(INode n)
Parameters
Type Name Description
INode n

Node.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetQuotedWithObject(Uri)

Selects all quoted triples where the Object is a Uri Node with the given Uri.

Declaration
public IEnumerable<Triple> GetQuotedWithObject(Uri u)
Parameters
Type Name Description
Uri u

Uri.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetQuotedWithObject(INode)

Selects all quoted triples where the Object is a given Node.

Declaration
public IEnumerable<Triple> GetQuotedWithObject(INode n)
Parameters
Type Name Description
INode n

Node.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetQuotedWithPredicate(Uri)

Selects all quoted triples where the Predicate is a Uri Node with the given Uri.

Declaration
public IEnumerable<Triple> GetQuotedWithPredicate(Uri u)
Parameters
Type Name Description
Uri u

Uri.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetQuotedWithPredicate(INode)

Selects all quoted triples where the Predicate is a given Node.

Declaration
public IEnumerable<Triple> GetQuotedWithPredicate(INode n)
Parameters
Type Name Description
INode n

Node.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetQuotedWithPredicateObject(INode, INode)

Selects all quoted triples with the given Predicate and Object.

Declaration
public IEnumerable<Triple> GetQuotedWithPredicateObject(INode pred, INode obj)
Parameters
Type Name Description
INode pred

Predicate.
INode obj

Object.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetQuotedWithSubject(Uri)

Selects all quoted triples where the Subject is a Uri Node with the given Uri.

Declaration
public IEnumerable<Triple> GetQuotedWithSubject(Uri u)
Parameters
Type Name Description
Uri u

Uri.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetQuotedWithSubject(INode)

Selects all quoted triples where the Subject is a given Node.

Declaration
public IEnumerable<Triple> GetQuotedWithSubject(INode n)
Parameters
Type Name Description
INode n

Node.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetQuotedWithSubjectObject(INode, INode)

Selects all quoted triples with the given Subject and Object.

Declaration
public IEnumerable<Triple> GetQuotedWithSubjectObject(INode subj, INode obj)
Parameters
Type Name Description
INode subj

Subject.
INode obj

Object.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetQuotedWithSubjectPredicate(INode, INode)

Selects all quoted triples with the given Subject and Predicate.

Declaration
public IEnumerable<Triple> GetQuotedWithSubjectPredicate(INode subj, INode pred)
Parameters
Type Name Description
INode subj

Subject.
INode pred

Predicate.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetSchema()

Declaration
public XmlSchema GetSchema()
Returns
Type Description
XmlSchema
| Edit this page View Source

GetTripleNode(Triple)

Selects the Triple Node with the given Triple value if it exists in the graph.

Declaration
public ITripleNode GetTripleNode(Triple triple)
Parameters
Type Name Description
Triple triple

Triple.
Returns
Type Description
ITripleNode

The triple node if it exists in the graph or else null.
| Edit this page View Source

GetTriples(Uri)

Selects all Triples which have a Uri Node with the given Uri.

Declaration
public IEnumerable<Triple> GetTriples(Uri uri)
Parameters
Type Name Description
Uri uri

Uri.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetTriples(INode)

Selects all Triples which contain the given Node.

Declaration
public IEnumerable<Triple> GetTriples(INode n)
Parameters
Type Name Description
INode n

Node.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetTriplesWithObject(Uri)

Selects all Triples where the Object is a Uri Node with the given Uri.

Declaration
public IEnumerable<Triple> GetTriplesWithObject(Uri u)
Parameters
Type Name Description
Uri u

Uri.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetTriplesWithObject(INode)

Selects all Triples where the Object is a given Node.

Declaration
public IEnumerable<Triple> GetTriplesWithObject(INode n)
Parameters
Type Name Description
INode n

Node.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetTriplesWithPredicate(Uri)

Selects all Triples where the Predicate is a Uri Node with the given Uri.

Declaration
public IEnumerable<Triple> GetTriplesWithPredicate(Uri u)
Parameters
Type Name Description
Uri u

Uri.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetTriplesWithPredicate(INode)

Selects all Triples where the Predicate is a given Node.

Declaration
public IEnumerable<Triple> GetTriplesWithPredicate(INode n)
Parameters
Type Name Description
INode n

Node.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetTriplesWithPredicateObject(INode, INode)

Selects all Triples with the given Predicate and Object.

Declaration
public IEnumerable<Triple> GetTriplesWithPredicateObject(INode pred, INode obj)
Parameters
Type Name Description
INode pred

Predicate.
INode obj

Object.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetTriplesWithSubject(Uri)

Selects all Triples where the Subject is a Uri Node with the given Uri.

Declaration
public IEnumerable<Triple> GetTriplesWithSubject(Uri u)
Parameters
Type Name Description
Uri u

Uri.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetTriplesWithSubject(INode)

Selects all Triples where the Subject is a given Node.

Declaration
public IEnumerable<Triple> GetTriplesWithSubject(INode n)
Parameters
Type Name Description
INode n

Node.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetTriplesWithSubjectObject(INode, INode)

Selects all Triples with the given Subject and Object.

Declaration
public IEnumerable<Triple> GetTriplesWithSubjectObject(INode subj, INode obj)
Parameters
Type Name Description
INode subj

Subject.
INode obj

Object.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetTriplesWithSubjectPredicate(INode, INode)

Selects all Triples with the given Subject and Predicate.

Declaration
public IEnumerable<Triple> GetTriplesWithSubjectPredicate(INode subj, INode pred)
Parameters
Type Name Description
INode subj

Subject.
INode pred

Predicate.
Returns
Type Description
IEnumerable<Triple>
| Edit this page View Source

GetUriNode(string)

Selects the Uri Node with the given QName if it exists in the Graph, returns null otherwise.

Declaration
public IUriNode GetUriNode(string qname)
Parameters
Type Name Description
string qname

QName.
Returns
Type Description
IUriNode

The Node if it exists in the Graph or null.
| Edit this page View Source

GetUriNode(Uri)

Selects the Uri Node with the given Uri if it exists in the Graph, returns null otherwise.

Declaration
public IUriNode GetUriNode(Uri uri)
Parameters
Type Name Description
Uri uri

Uri.
Returns
Type Description
IUriNode

The Node if it exists in the Graph or null.
| Edit this page View Source

HasSubGraph(IGraph)

Checks whether this Graph has the given Graph as a sub-graph.

Declaration
public bool HasSubGraph(IGraph g)
Parameters
Type Name Description
IGraph g

Graph.
Returns
Type Description
bool
| Edit this page View Source

HasSubGraph(IGraph, out Dictionary<INode, INode>)

Checks whether this Graph has the given Graph as a sub-graph.

Declaration
public bool HasSubGraph(IGraph g, out Dictionary<INode, INode> mapping)
Parameters
Type Name Description
IGraph g

Graph.
Dictionary<INode, INode> mapping

Mapping of Blank Nodes.
Returns
Type Description
bool
| Edit this page View Source

IsSubGraphOf(IGraph)

Checks whether this Graph is a sub-graph of the given Graph.

Declaration
public bool IsSubGraphOf(IGraph g)
Parameters
Type Name Description
IGraph g

Graph.
Returns
Type Description
bool
| Edit this page View Source

IsSubGraphOf(IGraph, out Dictionary<INode, INode>)

Checks whether this Graph is a sub-graph of the given Graph.

Declaration
public bool IsSubGraphOf(IGraph g, out Dictionary<INode, INode> mapping)
Parameters
Type Name Description
IGraph g

Graph.
Dictionary<INode, INode> mapping

Mapping of Blank Nodes.
Returns
Type Description
bool
| Edit this page View Source

Merge(IGraph)

Merges the given Graph into this Graph.

Declaration
public void Merge(IGraph g)
Parameters
Type Name Description
IGraph g

Graph to merge.
Remarks

The Graph should raise the MergeRequested event at the start of the Merge operation and abort the operation if the operation is cancelled by an event handler. On completing the Merge the Merged event should be raised.

| Edit this page View Source

Merge(IGraph, bool)

Merges the given Graph into this Graph.

Declaration
public void Merge(IGraph g, bool keepOriginalGraphUri)
Parameters
Type Name Description
IGraph g

Graph to merge.
bool keepOriginalGraphUri

Indicates that the Merge should preserve the Graph URIs of Nodes.
Remarks

The Graph should raise the MergeRequested event at the start of the Merge operation and abort the operation if the operation is cancelled by an event handler. On completing the Merge the Merged event should be raised.

| Edit this page View Source

RaiseTripleEvent(Triple, bool)

Helper method for raising the triple events manually

Declaration
protected void RaiseTripleEvent(Triple t, bool asserted)
Parameters
Type Name Description
Triple t

Triple
bool asserted

True to raise TripleAsserted, false to raise TripleRetracted
| Edit this page View Source

ReadXml(XmlReader)

Declaration
public void ReadXml(XmlReader reader)
Parameters
Type Name Description
XmlReader reader
| Edit this page View Source

ResolveQName(string)

Resolve a QName to a URI using this factory's NamespaceMap and BaseUri.

Declaration
public Uri ResolveQName(string qname)
Parameters
Type Name Description
string qname
Returns
Type Description
Uri
| Edit this page View Source

Retract(IEnumerable<Triple>)

Retracts an Enumerable of Triples from the Graph.

Declaration
public bool Retract(IEnumerable<Triple> ts)
Parameters
Type Name Description
IEnumerable<Triple> ts

Enumerable of Triples.
Returns
Type Description
bool
| Edit this page View Source

Retract(Triple)

Retracts a Triple from the Graph.

Declaration
public bool Retract(Triple t)
Parameters
Type Name Description
Triple t

A Triple.
Returns
Type Description
bool
| Edit this page View Source

Unstar()

Converts an graph containing quoted triples into to a graph with no quoted triples by applying the unstar operation described in https://w3c.github.io/rdf-star/cg-spec/2021-12-17.html#mapping.

Declaration
public void Unstar()
Remarks

The unstar operation modifies the graph in-place by calls to Assert(Triple) an Retract(Triple).

| Edit this page View Source

WriteXml(XmlWriter)

Declaration
public void WriteXml(XmlWriter writer)
Parameters
Type Name Description
XmlWriter writer

Events

| Edit this page View Source

Changed

Event which is raised when the Graph contents change

Declaration
public event GraphEventHandler Changed
Event Type
Type Description
GraphEventHandler
| Edit this page View Source

ClearRequested

Event which is raised just before the Graph is cleared of its contents

Declaration
public event CancellableGraphEventHandler ClearRequested
Event Type
Type Description
CancellableGraphEventHandler
| Edit this page View Source

Cleared

Event which is raised after the Graph is cleared of its contents

Declaration
public event GraphEventHandler Cleared
Event Type
Type Description
GraphEventHandler
| Edit this page View Source

MergeRequested

Event which is raised just before a Merge operation begins on the Graph

Declaration
public event CancellableGraphEventHandler MergeRequested
Event Type
Type Description
CancellableGraphEventHandler
| Edit this page View Source

Merged

Event which is raised when a Merge operation is completed on the Graph

Declaration
public event GraphEventHandler Merged
Event Type
Type Description
GraphEventHandler
| Edit this page View Source

TripleAsserted

Event which is raised when a Triple is asserted in the Graph

Declaration
public event TripleEventHandler TripleAsserted
Event Type
Type Description
TripleEventHandler
Remarks

Whenever this event is raised the Changed event should also be raised

| Edit this page View Source

TripleRetracted

Event which is raised when a Triple is retracted from the Graph

Declaration
public event TripleEventHandler TripleRetracted
Event Type
Type Description
TripleEventHandler
Remarks

Whenever this event is raised the Changed event should also be raised

Implements

Extension Methods