Class DatasetFileManager

Allows you to treat an RDF Dataset File - NQuads, TriG or TriX - as a read-only generic store.

Inheritance
System.Object
BaseAsyncSafeConnector
DatasetFileManager
Implements
System.IDisposable
Inherited Members
object.Equals(object)
object.Equals(object, object)
object.GetHashCode()
object.GetType()
object.MemberwiseClone()
object.ReferenceEquals(object, object)
Namespace: VDS.RDF.Storage
Assembly: dotNetRdf.dll
Syntax
public class DatasetFileManager : BaseAsyncSafeConnector, IAsyncStorageProvider, IQueryableStorage, IStorageProvider, IStorageCapabilities, IDisposable, IConfigurationSerializable

Constructors

| Improve this Doc View Source

DatasetFileManager(string, bool)

Creates a new Dataset File Manager.

Declaration
public DatasetFileManager(string filename, bool isAsync)
Parameters
Type Name Description
string filename

File to load from.
System.Boolean isAsync

Whether to load asynchronously.

Properties

| Improve this Doc View Source

DeleteSupported

Returns that deleting graphs is not supported.

Declaration
public override bool DeleteSupported { get; }
Property Value
Type Description
System.Boolean
Overrides
| Improve this Doc View Source

IOBehaviour

Gets the Save Behaviour of the Store.

Declaration
public override IOBehaviour IOBehaviour { get; }
Property Value
Type Description
IOBehaviour
Overrides
| Improve this Doc View Source

IsReadOnly

Returns that the Manager is read-only.

Declaration
public override bool IsReadOnly { get; }
Property Value
Type Description
System.Boolean
Overrides
| Improve this Doc View Source

IsReady

Returns that the Manager is ready if the underlying file has been loaded.

Declaration
public override bool IsReady { get; }
Property Value
Type Description
System.Boolean
Overrides
| Improve this Doc View Source

ListGraphsSupported

Returns that listing graphs is supported.

Declaration
public override bool ListGraphsSupported { get; }
Property Value
Type Description
System.Boolean
Overrides
| Improve this Doc View Source

SourceFile

Gets the Source File this manager represents a read-only view of.

Declaration
public string SourceFile { get; }
Property Value
Type Description
string
| Improve this Doc View Source

UpdateSupported

Returns that Updates are not supported since this is a read-only connection.

Declaration
public override bool UpdateSupported { get; }
Property Value
Type Description
System.Boolean
Overrides

Methods

| Improve this Doc View Source

DeleteGraph(string)

Throws an error since this connection is read-only.

Declaration
public override void DeleteGraph(string graphUri)
Parameters
Type Name Description
string graphUri

URI of the Graph to delete.
Overrides
Exceptions
Type Condition
RdfStorageException

Thrown since you cannot delete a Graph from a read-only connection.
| Improve this Doc View Source

DeleteGraph(Uri)

Throws an error since this connection is read-only.

Declaration
public override void DeleteGraph(Uri graphUri)
Parameters
Type Name Description
System.Uri graphUri

URI of the Graph to delete.
Overrides
Exceptions
Type Condition
RdfStorageException

Thrown since you cannot delete a Graph from a read-only connection.
| Improve this Doc View Source

Dispose()

Disposes of the Manager.

Declaration
public override void Dispose()
Overrides
| Improve this Doc View Source

ListGraphNames()

Gets an enumeration of the names of the graphs in the store.

Declaration
public override IEnumerable<string> ListGraphNames()
Returns
Type Description
System.Collections.Generic.IEnumerable<T><string>
Overrides
Remarks

Implementations should implement this method only if they need to provide a custom way of listing Graphs. If the Store for which you are providing a manager can efficiently return the Graphs using a SELECT DISTINCT ?g WHERE { GRAPH ?g { ?s ?p ?o } } query then there should be no need to implement this function.

| Improve this Doc View Source

ListGraphs()

Gets the list of URIs of Graphs in the Store.

Declaration
[Obsolete("Replaced by ListGraphNames")]
public override IEnumerable<Uri> ListGraphs()
Returns
Type Description
System.Collections.Generic.IEnumerable<T><System.Uri>
Overrides
| Improve this Doc View Source

LoadGraph(IGraph, string)

Loads a Graph from the Dataset.

Declaration
public override void LoadGraph(IGraph g, string graphUri)
Parameters
Type Name Description
IGraph g

Graph to load into.
string graphUri

URI of the Graph to load.
Overrides
| Improve this Doc View Source

LoadGraph(IGraph, Uri)

Loads a Graph from the Dataset.

Declaration
public override void LoadGraph(IGraph g, Uri graphUri)
Parameters
Type Name Description
IGraph g

Graph to load into.
System.Uri graphUri

URI of the Graph to load.
Overrides
| Improve this Doc View Source

LoadGraph(IRdfHandler, string)

Loads a Graph from the Dataset with the given Handler.

Declaration
public override void LoadGraph(IRdfHandler handler, string graphUri)
Parameters
Type Name Description
IRdfHandler handler

RDF Handler.
string graphUri

URI of the Graph to load.
Overrides
| Improve this Doc View Source

LoadGraph(IRdfHandler, Uri)

Loads a Graph from the Dataset with the given Handler.

Declaration
public override void LoadGraph(IRdfHandler handler, Uri graphUri)
Parameters
Type Name Description
IRdfHandler handler

RDF Handler.
System.Uri graphUri

URI of the Graph to load.
Overrides
| Improve this Doc View Source

Query(string)

Makes a query against the in-memory copy of the Stores data.

Declaration
public object Query(string sparqlQuery)
Parameters
Type Name Description
string sparqlQuery

SPARQL Query.
Returns
Type Description
System.Object
| Improve this Doc View Source

Query(IRdfHandler, ISparqlResultsHandler, string)

Makes a query against the in-memory copy of the Stores data processing the results with one of the given handlers.

Declaration
public void Query(IRdfHandler rdfHandler, ISparqlResultsHandler resultsHandler, string sparqlQuery)
Parameters
Type Name Description
IRdfHandler rdfHandler

RDF Handler.
ISparqlResultsHandler resultsHandler

Results Handler.
string sparqlQuery

SPARQL Query.
| Improve this Doc View Source

SaveGraph(IGraph)

Throws an error since this Manager is read-only.

Declaration
public override void SaveGraph(IGraph g)
Parameters
Type Name Description
IGraph g

Graph to save.
Overrides
Exceptions
Type Condition
RdfStorageException

Always thrown since this Manager provides a read-only connection.
| Improve this Doc View Source

SerializeConfiguration(ConfigurationSerializationContext)

Serializes the connection's configuration.

Declaration
public void SerializeConfiguration(ConfigurationSerializationContext context)
Parameters
Type Name Description
ConfigurationSerializationContext context

Configuration Serialization Context.
| Improve this Doc View Source

ToString()

Gets the String representation of the Connection.

Declaration
public override string ToString()
Returns
Type Description
string
Overrides
object.ToString()
| Improve this Doc View Source

UpdateGraph(string, IEnumerable<Triple>, IEnumerable<Triple>)

Throws an error since this Manager is read-only.

Declaration
public override void UpdateGraph(string graphUri, IEnumerable<Triple> additions, IEnumerable<Triple> removals)
Parameters
Type Name Description
string graphUri

Graph URI.
System.Collections.Generic.IEnumerable<T><Triple> additions

Triples to be added.
System.Collections.Generic.IEnumerable<T><Triple> removals

Triples to be removed.
Overrides
| Improve this Doc View Source

UpdateGraph(Uri, IEnumerable<Triple>, IEnumerable<Triple>)

Throws an error since this Manager is read-only.

Declaration
public override void UpdateGraph(Uri graphUri, IEnumerable<Triple> additions, IEnumerable<Triple> removals)
Parameters
Type Name Description
System.Uri graphUri

Graph URI.
System.Collections.Generic.IEnumerable<T><Triple> additions

Triples to be added.
System.Collections.Generic.IEnumerable<T><Triple> removals

Triples to be removed.
Overrides
| Improve this Doc View Source

UpdateGraph(IRefNode, IEnumerable<Triple>, IEnumerable<Triple>)

Updates a Graph in the Store.

Declaration
public override void UpdateGraph(IRefNode graphName, IEnumerable<Triple> additions, IEnumerable<Triple> removals)
Parameters
Type Name Description
IRefNode graphName

Name of the Graph to update.
System.Collections.Generic.IEnumerable<T><Triple> additions

Triples to be added.
System.Collections.Generic.IEnumerable<T><Triple> removals

Triples to be removed.
Overrides
Remarks

Note: Not all Stores are capable of supporting update at the individual Triple level and as such it is acceptable for such a Store to throw a NotSupportedException or an RdfStorageException if the Store cannot provide this functionality.

Behaviour of this method with regards to non-existent Graph is up to the implementor, it may create a new empty Graph and apply the updates to that or it may throw an error. Implementors should state in the XML comments for their implementation what behaviour is implemented.

Implementers MUST allow for either the additions or removals argument to be null.

Exceptions
Type Condition
System.NotSupportedException

May be thrown if the underlying Store is not capable of doing Updates at the Triple level.
RdfStorageException

May be thrown if the underlying Store is not capable of doing Updates at the Triple level or if some error occurs while attempting the Update.

Implements

System.IDisposable

Extension Methods